প্রকল্প সম্পর্কে

এই রিপোজিটরিতে "The Rust Programming Language"-এর সোর্স রয়েছে, যা রাস্ট ভাষার জন্য আদর্শ পরিচায়ক বই। সমাপ্ত বইটি No Starch Press থেকে মুদ্রিত আকারে প্রকাশিত হয় এবং অনলাইনেও বিনামূল্যে পাওয়া যায়, যা স্টেবল, বিটা এবং নাইটলি রাস্ট রিলিজের সাথে পাঠানো হয় (যদিও সেই বান্ডেল কপিগুলো এখানে করা সংশোধনের চেয়ে পিছিয়ে থাকতে পারে)। একটি রিলিজ পৃষ্ঠা বইতে থাকা সব লিস্টিংয়ের জন্য ডাউনলোডযোগ্য কোড সরবরাহ করে। বইটি মার্কডাউনে লেখা এবং mdBook দিয়ে রেন্ডার করা হয়, যা বইয়ের জন্য রাস্ট কমিউনিটির স্ট্যাটিক-সাইট জেনারেটর। বিল্ড করতে নির্দিষ্ট mdBook সংস্করণ ইনস্টল করতে হয় (যেটি rust-lang/rust-এর rustbook টুলিংয়ে পিন করা আছে) `cargo install mdbook --locked --version <version_num>` কমান্ডের মাধ্যমে, তারপর `mdbook build` চালিয়ে `book` সাবডিরেক্টরিতে একটি স্ট্যাটিক সাইট তৈরি হয়, যেকোনো ব্রাউজারে দেখা যায়। README-তে Linux, macOS এবং Windows-এ (PowerShell এবং Cmd উভয়ই) Firefox এবং Chrome-এর জন্য ব্রাউজার চালুর কমান্ড নথিভুক্ত রয়েছে। কোড উদাহরণের পরীক্ষাগুলো `packages/trpl`-এর অধীনে থাকে এবং `mdbook test --library-path packages/trpl/target/debug/deps` দিয়ে চালানো হয়। CONTRIBUTING.md নির্দেশিকার মাধ্যমে অবদান স্বাগত, তবে যেহেতু বইটি মুদ্রিত হয় এবং রক্ষণাবেক্ষণকারীরা অনলাইন সংস্করণটি মুদ্রিত সংস্করণের কাছাকাছি রাখতে চান, তাই সংশোধনগুলো রাস্ট এডিশন রিলিজের চারপাশে ব্যাচ করা হয়। সেই বড় সংশোধনগুলোর মধ্যে, শুধুমাত্র কঠোর ভুল সংশোধন একীভূত হয়, তাই ভুল নয় এমন পুল রিকোয়েস্টগুলো মাস বা বছর অপেক্ষা করতে পারে। অনুবাদগুলো Translations লেবেলের মাধ্যমে ট্র্যাক করা হয় এবং নতুন ভাষার প্রচেষ্টা issue হিসেবে খোলা যেতে পারে, তবে একীভূতকরণ mdBook-এর বহু-ভাষা সমর্থনের জন্য অপেক্ষা করে। `ci/spellcheck.sh` স্ক্রিপ্ট এবং `ci/dictionary.txt` অভিধান বানান পরীক্ষায় সহায়তা করে, যেখানে মিথ্যা পজিটিভ (যেমন `BTreeMap`-এর মতো শনাক্তকারী) সাজানো ক্রমে অভিধানে যোগ করা হয়। সামগ্রিকভাবে, এটি রানটাইম টুলের পরিবর্তে একটি ডকুমেন্টেশন এবং শিক্ষামূলক প্রকল্প: ব্যবহারকারীদের জন্য এর মূল্য রাস্টের জন্য কর্তৃত্বপূর্ণ শেখার সংস্থান হিসাবে, সাথে সু-নথিভুক্ত বিল্ড পাইপলাইন, কোড নমুনার জন্য টেস্টিং হারনেস এবং একটি কাঠামোবদ্ধ অবদান ও অনুবাদ কর্মপ্রবাহ।