ইন-কোড ডকুমেন্টেশন
সর্বাধিক গুরুত্বপূর্ণ বিষয়টি হল আপনার নির্বাচিত বিকাশের পরিবেশে ডকুমেন্টেশন সুবিধাগুলি ব্যবহার করা, সুতরাং এর অর্থ পাইথনের জন্য পাইডোক , জাভাতে জাভাদোক বা সি # তে এক্সএমএল মন্তব্য । এগুলি কোড লেখার সাথে সাথে একই সাথে ডকুমেন্টেশন লিখতে সহজ করে তোলে।
আপনি যদি পরে ফিরে এসে জিনিসপত্রগুলি ডকুমেন্ট করার উপর নির্ভর করেন তবে আপনি এটির কাছাকাছি নাও যেতে পারেন, তবে কোডটি লেখার সময় আপনি যদি এটি করেন তবে কী কী নথিভুক্ত করা দরকার তা আপনার মনে তাজা হয়ে উঠবে। যদি এক্সএমএল ডকুমেন্টেশন প্রকৃত কোডের সাথে অসম্পূর্ণ বা অসম্পূর্ণ থাকে তবে সি # তেও একটি সংকলন সতর্কতা জারি করার বিকল্প রয়েছে।
ডকুমেন্টেশন হিসাবে পরীক্ষা
আরেকটি গুরুত্বপূর্ণ বিষয় হ'ল ভাল সংহতকরণ এবং ইউনিট পরীক্ষা করা।
প্রায়শই ডকুমেন্টেশন ক্লাস এবং পদ্ধতিগুলি বিচ্ছিন্নতার ক্ষেত্রে কীভাবে মনোনিবেশ করে সেগুলি কীভাবে আপনার সমস্যা সমাধানের জন্য একসাথে ব্যবহৃত হয় তা এড়িয়ে যায়। পরীক্ষাগুলি এগুলি একে অপরের সাথে কীভাবে ইন্টারঅ্যাক্ট করে তা দেখিয়ে প্রায়শই প্রসঙ্গে ফেলে।
একইভাবে, ইউনিট-পরীক্ষাগুলি প্রায়শই বাহ্যিক নির্ভরতাগুলি সুস্পষ্টভাবে নির্দেশ করে যার মাধ্যমে জিনিসগুলি মক এড আউট করা দরকার।
আমি আরও দেখতে পেয়েছি যে টেস্ট-চালিত বিকাশ ব্যবহার করে আমি এমন সফ্টওয়্যার লিখি যা ব্যবহার করা সহজ, কারণ আমি এটি গো শব্দটি থেকে ব্যবহার করছি। একটি ভাল পরীক্ষার কাঠামোর সাথে, কোডটি পরীক্ষা করা সহজ করে দেওয়া এবং এটি ব্যবহার করা সহজ করে তোলে প্রায়শই একই জিনিস।
উচ্চ স্তরের ডকুমেন্টেশন
অবশেষে সিস্টেম স্তর এবং আর্কিটেকচারাল ডকুমেন্টেশন সম্পর্কে কী করা উচিত। অনেকে উইকিতে এই জাতীয় ডকুমেন্টেশন লেখার বা ওয়ার্ড বা অন্যান্য ওয়ার্ড প্রসেসর ব্যবহারের পক্ষে পরামর্শ দিতেন, তবে আমার কাছে এই জাতীয় ডকুমেন্টেশনের জন্য সেরা জায়গাটি কোডের পাশাপাশি একটি সাধারণ টেক্সট ফর্ম্যাটে যা সংস্করণ নিয়ন্ত্রণ ব্যবস্থা বান্ধব।
ইন-কোড ডকুমেন্টেশনের মতোই, আপনি যদি নিজের কোড সংগ্রহস্থলে আপনার উচ্চ স্তরের ডকুমেন্টেশনগুলি সংরক্ষণ করেন তবে আপনি এটি আপ টু ডেট রাখার সম্ভাবনা বেশি। আপনি এই সুবিধাটি পাবেন যে আপনি যখন কোডটির XY সংস্করণটি বের করেন, আপনি ডকুমেন্টেশনের XY সংস্করণও পান। এছাড়াও, আপনি যদি ভিসিএস বান্ধব ফর্ম্যাট ব্যবহার করেন তবে এর অর্থ হল আপনার কোডের মতো আপনার ডকুমেন্টেশনগুলিকে শাখা করা, আলাদা করা এবং মার্জ করা সহজ।
আমি বেশ মত reStructuredText (প্রথম) , যেমন ব্যবহার করে এটি থেকে উভয় HTML পৃষ্ঠা এবং PDF ডকুমেন্ট তৈরী করা সহজ স্পিংক্স , এবং তুলনায় অনেক বন্ধুত্বপূর্ণ হয় ক্ষীর , এখনো এখনও অন্তর্ভুক্ত করতে পারে লেটেক্ গণিত এক্সপ্রেশন যখন আপনি তাদের প্রয়োজন।