সবকিছু থেকে হ্যাক ডকুমেন্ট।
ডকুমেন্টেশন শুরু করার বিষয়ে স্ল্যাশডোটে সম্প্রতি একটি থ্রেড ছিল যা আমাকে ডকুমেন্টেশন সম্পর্কে আমার চিন্তাভাবনা লিখতে অনুপ্রাণিত করেছিল।
আমার মূল বিষয়গুলি ছিল:
নীতি # 1: এটি কখনও হয় নি
ডকুমেন্টেশন একটি চলমান প্রচেষ্টা যা উত্পাদনে যা আছে তার চেয়ে সর্বদা পিছিয়ে থাকবে। পরিবর্তনগুলি এড-হক তৈরি করা হয়, জিনিসগুলি প্রায় সরানো বা বন্ধ করা হয় বা এলোমেলোভাবে পরিষেবাতে রাখা হয়। ডকুমেন্টেশন কখনই ধরা পড়বে না।
চলমান ডকুমেন্টেশন আপ টু ডেট রাখার জন্য আপনাকে বিল পরিশোধ করার সময় (এবং সেইজন্য, অর্থ) মূল্য দিয়ে লোককে বিক্রি করতে হবে। প্রায়শই এই কথোপকথনগুলি এরকম হয়: "মনে আছে কখন আমাকে I সময় ব্যয় করতে হয়েছিল remember জিনিসটি কীভাবে ভেঙে গেছে Well ভাল আমি যখন শেষ করেছি, তখন এই প্রযুক্তি নোটটি বিশদ বিবরণ ছিল $ জিনিসটি, যাতে পরের লোকটি আসবে না এটি সব খুঁজে বের করতে হবে। "
আপনি এটি করতে হবে, যদিও আপনি কখনই শেষ করবেন না।
নীতি # 2: কোনও ডকুমেন্টেশনের চেয়ে একমাত্র জিনিসটি সবচেয়ে খারাপ, ডকুমেন্টেশন ভুল
এটি একটি নীতির চেয়ে বিশ্বাসঘাতকতা বেশি। ডকুমেন্টেশন আপনাকে ভ্রান্ত ধারণা থেকে দূরে সরিয়ে দিতে পারে যে কিছু জ্ঞাত অবস্থায় রয়েছে এবং যদি কিছু ভুল হয়ে যায় তবে আপনাকে ঠিক করার সময় এটি শুরু করতে পারে।
এই সমস্যাটি স্বীকার করা গুরুত্বপূর্ণ।
নীতি # 3: আপনি আপনার উত্তরাধিকারীর জন্য ডকুমেন্টেশন লিখছেন
প্রতিক্রিয়া আপনি নথির যে কোনও কিছুর 95% হ'ল আপনাকে আর কখনও উল্লেখ করতে হবে না। ডকুমেন্টেশন আপনার জন্য নয়, ভবিষ্যতের জন্য জ্ঞানের সংগ্রহ। সুতরাং আপনাকে ধরে নিতে হবে যে আপনার শ্রোতারা জিনিসগুলি যেভাবে হয় তার নির্দিষ্টকরণ সম্পর্কে খুব কম বা কিছুই জানে না।
এবং একজন উত্তরসূরি হবে। আমি আপনার সম্পর্কে জানি না, তবে আমি সারা জীবন এই নির্দিষ্ট পরিবেশে থাকার পরিকল্পনা করি না। সুযোগগুলি আসে এবং যায়, এবং যখন তারা আসে, কখনও কখনও আপনি যান। তবে জীবন আপনার পিছনে চলে যায়, এবং আপনি আপনার উত্তরসূরির জন্য জীবনকে আরও সুন্দর করে তুলতে পারেন smo অন্যথায় আপনার কাছে প্রাক্তন গ্রাহকদের একটি সংগ্রহ থাকতে পারে যারা চুপচাপ আপনার সম্পর্কে অবাস্তব জিনিস বলে। আমি বলতে চাই যে এটি একই 50 জন অটোয়ার আইটি-তে সর্বত্র কাজ করছে কারণ আপনি সর্বত্র তাদের মধ্যে চালিয়ে যান। আপনার উত্তরসূরিকে সহায়তা করা ভবিষ্যতে আপনার জন্য দ্বার উন্মুক্ত করতে পারে।
এখন নির্দিষ্ট পরিমাণে যখন সমস্যা চলে আসে তখন সর্বদা "পূর্ববর্তী লোকটিকে দোষারোপ করুন" এর একটি ডিগ্রি থাকে। এটা ব্যবসায়ের অংশ। আমি নিজেই করে ফেলেছি। তবে বেশ কয়েকবার যখন আমি পূর্বের লোকটিকে একরকম মুরন বলে ধমক দিয়েছিলাম তখন আমি অন্যথায় শিখেছি যে সে সত্যিই তার অভিনয়টি করেছিল এবং আমি যা করেছি তার চেয়ে আমার কী জানা ছিল সে সম্পর্কে আরও জানত।
নীতি # 4: "কেন" এর চেয়ে "কেন" প্রায়শই গুরুত্বপূর্ণ
কোনও সিস্টেমের দিকে তাকালে আমাদের বেশিরভাগই ভাবতে শুরু করে যে নরকটি এরকম কেন? কনফিগারেশন পছন্দগুলি করার জন্য প্রায় সবসময় খুব নির্দিষ্ট কারণ রয়েছে। এই পরিস্থিতিতে, "কেন" "কীভাবে" নির্দেশ দেয় এবং আপনাকে নিশ্চিত করতে হবে যে ধূমপানটি আপনার সমাধানের অবশিষ্টাংশ পরীক্ষা করার সময় পাঠক নির্দিষ্ট সমস্যার সমাধান করছেন কিনা তা বুঝতে পেরেছেন।
নীতি # 5: এটি সহজ হতে হবে বা আপনি এটি করবেন না
এর অর্থ আপনার সরঞ্জামগুলির পাশাপাশি আপনার সরঞ্জামগুলি যারা ব্যবহার করছেন তাদের সম্পর্কে আপনাকে খুব সচেতন হতে হবে।
জিনিসগুলি আপ টু ডেট রাখা সহজ হতে হবে be যদি আপনাকে কোনও ধরণের প্রচেষ্টা করতে হয়, তবে আপনি যখন এটি সর্বোত্তমভাবে করা হয় তখন তা করা এড়াতে অজুহাত খুঁজে পাবেন, যা পরিবর্তনের পরপরই।
যদি আপনার সরঞ্জামগুলি অন্যের পক্ষে ব্যবহার করা সহজ না হয় তবে তারা এগুলি ব্যবহার করবে না। এটি বিশেষত একটি দলের পরিবেশে পঙ্গু হতে পারে, যেহেতু বড় দলটি তত বেশি সম্ভাবনা অর্জন করে আপনি এমন কোনও দলের সদস্যের মুখোমুখি হবেন যিনি আপনার সরঞ্জাম পছন্দ পছন্দ করেন না।
ব্যক্তিগতভাবে, আমি নথির জন্য একটি উইকি পছন্দ করি। তবে সমস্যাটি হ'ল কোনও উইকি আপনার উপর কোনও কাঠামো চাপিয়ে দেয় না, সুতরাং কাঠামোটি বাইরে থেকে চাপানো উচিত। এটি সর্বদা কোথাও কোথাও কোথাও বিরোধের দিকে পরিচালিত করে কারণ অন্য কারওর থেকে ভাল / আলাদা ধারণা রয়েছে।
কিছু জায়গায় আমি ওয়ার্ড এবং ভিসিও নথিগুলি পিডিএফে "প্রকাশিত" ব্যবহার করেছি, "সর্বশেষ" পিডিএফকে অনুমোদনযোগ্য হিসাবে বিবেচনা করা হচ্ছে। এটি আপনার পক্ষে তখন একটি সংগ্রহ রয়েছে যা আপনি আপনার নিয়োগকর্তা / উত্তরসূরির কাছে হস্তান্তর করতে পারেন in পিডিএফগুলি, যদি সঠিকভাবে তারিখ করা হয় তবে কী ঘটেছিল তার একটি historicalতিহাসিক রেকর্ড সরবরাহ করতে পারে, তবে এটি যা চলাচল করা সহজ নয়। এটা খারাপ যে আমি ওয়ার্ড বা ভিসিও পছন্দ করি না এবং ধারণাগুলিকে কার্যকরভাবে যোগাযোগ করার জন্য এই সরঞ্জামগুলির একটি প্রাথমিক ধারণা পেতে বাধ্য করা হয়েছে।
আমার বর্তমান নিয়োগকর্তা একটি শেয়ারপয়েন্ট পোর্টালে ওয়ার্ড ডকুমেন্টের ধারণাটি নিয়ে কাজ করছেন। আমরা কেবল সেখানে পৌঁছতে হবে তা দেখতে হবে