আমি খুঁজে পেয়েছি যে কোনও ডকুমেন্টেশন কোনও ডকুমেন্টেশনের চেয়ে ভাল। উপযুক্ত পরিমাণটি সাধারণত আমাদের কতটা সময় করতে হয় তা দ্বারা নির্ধারিত হয়, বা আমরা সমর্থন ফোন কল এবং ইমেলগুলিকে কতটা ঘৃণা করি।
এটি প্রদর্শিত হয় যে আপনার বর্তমান দলের সদস্যদের তাদের স্মৃতি সম্পর্কে কিছু অবাস্তব প্রত্যাশা রয়েছে বা তারা তাদের লেখার দক্ষতার জন্য লজ্জিত, এবং অনুশীলন করতে রাজি নয়।
আমি বুঝতে পারি যে আমি এখানে সংখ্যালঘুতে আছি (ইংলিশ মেজর যারা স্নাতক স্কুলে সফটওয়্যার ইঞ্জিনিয়ারিংয়ে ভর্তি হয়েছিল), আমি কোরে কোথাও ডকুমেন্টেশন পাই না। এটি একটি মূল্যবান পেশাদার সরঞ্জাম। আমার কয়েকজন সহকর্মীর মতো লেখার পক্ষে লেখাপড়া করা আমার পক্ষে কঠিন মনে হতে পারে না তবে এটি বেশিরভাগ কারণেই আমার এতে আরও অনুশীলন রয়েছে। আমি কোনও প্রকল্পের ডকুমেন্টেশন না থাকলে শেষ হয়েছে বলে বিবেচনা করি না এবং আমি সাধারণত নিখুঁত স্বার্থপর কারণেই এটি লিখি: তাই আমি ফোন কল এবং ইমেল না দিয়ে লোকদের পড়ার জন্য কিছু দিতে পারি, বা তাই আমরা শেষের দিকে কী বলছিলাম তা মনে রাখতে পারি মাস, বা তাই রাতের মাঝামাঝি সময়ে যদি আমাকে এটির সমর্থন প্রয়োজন হয় তবে আমি কীভাবে কিছু করেছি তা উল্লেখ করতে পারি।
ডকুমেন্টেশনের কাছে যাওয়ার সর্বোত্তম উপায় হ'ল এটি যেমন আপনি যান ঠিক তেমন লেখার মতো পরীক্ষার কোডটি। এটি কয়েকটি আশ্চর্যজনক যে কীভাবে কয়েকটি প্রাক লিখিত টেম্পলেটগুলি (শিরোনাম, কোডের স্টাব ইত্যাদির সাহায্যে) ডকুমেন্টেশনকে আরও সহজ এবং দ্রুত করতে পারে। এইভাবে আপনি পরিবর্তনটি যেমন ঘটবে তেমন ক্যাপচার করতে পারবেন এবং সময়ের সাথে সাথে আপনার coverাকতে কম জমি থাকবে। আপনি এইভাবে আরও দক্ষ, যেহেতু আপনার প্রয়োজন হিসাবে ডকুমেন্টেশনগুলিকে উল্লেখ করতে পারেন এবং আপনি এটি পথ পরিবর্তন করে। উদাহরণস্বরূপ, একটি উইকিতে এটি করা আপডেটগুলি সহজ করে তোলে এবং সর্বশেষতম এবং সর্বশ্রেষ্ঠ একই স্থানে অনলাইনে থাকাকালীন আপনি ডকুমেন্ট সংস্করণ সম্পর্কিত সমস্যাগুলি এড়াতে পারবেন এবং আপনি যেসব ব্যক্তিকে এটি পড়তে হবে তাদের লিঙ্কগুলি প্রেরণ করতে পারেন।
আপনি যদি ডকুমেন্টিংয়ের জন্য কিছুটা সময় ব্যয় করেন তবে আপনি সমস্ত দ্রুত কাজ করবেন, বিশেষত যখন কোনও নতুন দলে যোগ দেবেন, যেহেতু তাদের সমস্ত কিছু বের করার জন্য সমস্ত সময় ব্যয় করতে হবে না। স্টাফ আউট আউট করা আমাদের কাজের একটি মজাদার অংশ, তবে আপনি যখন উত্পাদন ঠিক করার জন্য তাড়াহুড়ো করে তা করতে মজা পাবেন না। আমরা সবাই আরও দু'টি নোট লিখলে আমরা সবাই অনেক সময় বাঁচাতে চাই।
আপনার দলের পরীক্ষার, বা পরীক্ষার কোড লেখার ক্ষেত্রে একই সমস্যা রয়েছে? যদি তা না হয় তবে এটি সহজ বিক্রয় হবে।
আপনার ডকুমেন্টেশন বিভিন্ন উপায়ে কার্যকর:
1) আপনি এখন, এবং আপনার সহকর্মীদের জন্য, যেমন আপনি প্রকল্পটিতে কাজ করেন।
2) আপনার গ্রাহকদের। ডকুমেন্টেশন থাকা (ডায়াগ্রাম সহ) যা আপনি ব্যবহারকারীদের দেখাতে পারেন তা সভাগুলিতে আলোচনা সহজ করে তোলে, বিশেষত যদি আপনি জটিল সিস্টেমগুলি নিয়ে আলোচনা করছেন। এমনকি ডকুমেন্টেশন অসম্পূর্ণ থাকলেও এটি থেকে শুরু করার জায়গা।
3) আপনার কাজের উত্তরাধিকারী ব্যক্তিদের কাছে (যা তিন বছরেও আপনি হতে পারেন)। আমার অনেক ছোট সহকর্মী মনে করেন তারা চিরকালের জন্য জিনিসগুলি মনে রাখবেন। আমি জানি আমি এটি লিখতে না পারলে এই সপ্তাহের আগে এটি মনে রাখব না। ডকুমেন্টেশন থাকা আপনার অর্ধেক দিন ব্যয় করা থেকে আপনি কীভাবে কোনও কিছুকে কাঠামোগত গঠন করেছিলেন তা পুনরুদ্ধার করে এবং এটি আবার বের করে আনে ves
৪) আপনার এবং অন্যদের কাছে পরিস্থিতি রাজনৈতিক বা বিতর্কিত হয়ে উঠলে। যে কেউ মিটিংয়ে নোট নেন, নিজেকে জাগ্রত রাখতে এবং বিরক্তির সাথে লড়াই করার জন্য, আমি প্রায়শই সিদ্ধান্তের লিখিত সংস্করণে একাই হয়েছি। যে ব্যক্তি এটি লিখেছিল সে বিবাদটি জয় করে। এটি পরের বারের মতো এটির কথা মনে রাখবেন "মনে রাখবেন যে আমরা এই শীতকালে সম্মেলনের চারটি সম্মেলনে বসেছিলাম, যখন আমরা এক্স পেরিয়ে যাচ্ছিলাম? ফ্রেড সেখানে ছিলেন, এবং অ্যাকাউন্টিংয়ের লোকটি কে?"