চৌকস প্রক্রিয়া: কীভাবে এবং কীভাবে ডকুমেন্ট করা উচিত?

Question

কিছুক্ষণ আগে আমি যে সংস্থার জন্য কাজ করি সে একটি তৃতীয় পক্ষের কাছে একটি উন্নয়ন প্রকল্প আউটসোর্স করেছিল। তারা সমাধানটি বিকাশে চতুর অভ্যাস নিযুক্ত করে। যাইহোক ডকুমেন্টেশন জিজ্ঞাসা করার সময় তারা কেবল এটি উইকিতে বা তাদের স্প্রিন্টের অংশ হিসাবে অন্তর্ভুক্ত করার কারণে এটি প্রয়োজনীয় ছিল বলে দেবে।

তারা প্রকল্পের একজন ছাড়া বাকি সবাই প্রকল্পটি শেষের সময় ছেড়ে যায়। প্রকল্পের উইকি সাইটটি এখন বার্ষিক সাবস্ক্রিপশন দেওয়ার কারণে বন্ধ হয়ে গেছে।

যখন তারা চলে যায় তখন তারা তাদের সাথে কী বিকাশ করা হয়েছিল তার বেশিরভাগ জ্ঞান এবং বোঝাপড়া গ্রহণ করে।

সুতরাং আমি 2 প্রধান প্রশ্ন আছে;

1. এটি চৈতন্যের জন্য স্বাভাবিক বা এটি না লেখার জন্য কেবল একটি অজুহাত?
2. বিকাশের প্রয়োজনীয়তা, ডিজাইন, মূল সিদ্ধান্ত এবং প্রসঙ্গে রেকর্ড করতে চতুর প্রকল্পগুলিতে ডকুমেন্টেশনের জন্য শিল্পের আদর্শ কী?

Comments

en.wikedia.org/wiki/There%27s_a_sucker_born_every_minute গুরুতরভাবে - আপনি কি en.wikedia.org/wiki/Bus_factor এর পূর্বাভাস দেন নি ? ভাল, একটি পাঠ শেখা সে কঠোরভাবে ভালভাবে শেখার ঝোঁক। আশা করি, আপনার জন্য, পরবর্তী সময় আসবে না (তবে আপনি এখনও ব্যবসায়ে

— থাকবেন

Answer 1

এটি চৈতন্যের জন্য স্বাভাবিক বা এটি না লেখার জন্য কেবল একটি অজুহাত?

আমার তত্ত্বটি হ'ল এ কারণেই চটপটি এত দ্রুত ছড়িয়ে পড়ে বিশেষত স্ক্রাম । আমি অনেক দলকে নিজের রক্ষার জন্য চটপটে চেয়ে দেখেছি (পুরো সংস্থার পরিবর্তে)। সমস্যাটি হ'ল অনেক ক্ষেত্রে, পদ্ধতিগুলি তাদের বিরুদ্ধে পরিচালনার মাধ্যমে ব্যবহৃত হয় (কারণ তারা নিজেরাই নিজেকে রক্ষা করতে চায়!)।

এর অর্থ কি চটপটে আদৌ কাজ করে না? অবশ্যই এটি নয়, এর অর্থ হ'ল চতুরতা আপনাকে কয়েকটি সাধারণ সমস্যা সমাধানে সহায়তা করে তবে আপনি এখনও অন্য সকলের দায়িত্বে আছেন। এবং অনেক ক্ষেত্রে চটজলদি সেই সংস্থার সেই দলের পক্ষে উপযুক্ত নয়।

বিকাশের প্রয়োজনীয়তা, ডিজাইন, মূল সিদ্ধান্ত এবং প্রসঙ্গে রেকর্ড করতে চতুর প্রকল্পগুলিতে ডকুমেন্টেশনের জন্য শিল্পের আদর্শ কী?

সংক্ষিপ্ত হতে:

দলের তাদের কতগুলি ডকুমেন্টেশন প্রয়োজন তা নির্ধারণ করা উচিত

তারা ডোমেনটি জানে, তারা বিশেষজ্ঞ এবং আরও গুরুত্বপূর্ণভাবে তারা জিনিসটি তৈরি করে!

যে কি ব্যাপক ডকুমেন্টেশন উপর ওয়ার্কিং সফ্টওয়্যার মধ্যে এজাইল ঘোষণা উপায়।

Answer 2

তারা কী আপনাকে টিডিডি টেস্ট, স্বীকৃতি পরীক্ষা, বা অন্যান্য ইউনিট টেস্টের একটি সেট রেখেছিল? কোনও অ্যাপ্লিকেশন কীভাবে কাজ করে এবং এটি কীভাবে প্রত্যাশিত তা কার্যকরী করার পাশাপাশি তারা কী কী কীভাবে বিকাশ হয়েছিল তা কীভাবে ব্যবহার করতে হবে তার একটি নমুনা বাস্তবায়ন সরবরাহ করার জন্য তারা ডকুমেন্ট করার একটি ভাল কাজ করে।

Comments

+1 হ্যাঁ, এটি নথির চতুর উপায় your যদি আপনার পরীক্ষাগুলি যথেষ্ট পরিমাণে ব্যর্থ হয় এবং চালিত হয় তবে আপনি নিশ্চিত হতে পারেন যে সিস্টেমটি যথাযথভাবে নথিভুক্ত হয়েছে (ডকুমেন্টেশন পৃথক রাখা এবং প্রকৃত কোডের সাথে সিঙ্কের বাইরে চলে যাওয়ার বিপরীতে)। ওহ, এবং আপনার সম্ভবত বড় ছবিটির জন্য কিছু ধরণের ব্রড পাখির চোখের দর্শন নথি দরকার।

— মার্টিন উইকম্যান

দুঃখের বিষয়, তারা যে পরীক্ষাগুলির পিছনে ফেলেছিল তার সংখ্যা এবং গুণাগুণ খুব কম ছিল, ব্যবহারিক ব্যবহারের কারণে এগুলি দ্রুত ফেলে দেওয়া হয়েছিল।

— গ্রম্পিমনকি

Answer 3

যদিও আমি কোনও উপায়ে চালিত বিশেষজ্ঞ নই, উত্তরে আমার চেষ্টা এখানে:

1. নির্দিষ্ট গল্পের জন্য কোন গল্প / প্রয়োজনীয়তা জিজ্ঞাসা করা হয়েছিল? যদি তা না হয়, তবে এটি সমস্যার একটি অংশ হিসাবে আপনি কিছুটা হলেও অনুরোধ পেয়েছেন। এটি একটি অজুহাত এবং আমি এখানে "সাধারণ" বলতে আপনার অর্থ কী তা আমি ভাবতে পারি। এটি কি কেবল চৌর্য নীতি অনুসরণকারীদের বেশিরভাগই যা কিছু স্বাভাবিক করে তোলে বা এটি সামগ্রিক প্রক্রিয়ার অংশ যা প্রত্যাশা করা উচিত? এগুলির জন্য আমি দুটি মত দেখতে পেলাম। সম্পাদনা: আমি সন্দেহ করি যে দলিল করার ক্ষেত্রে বেশিরভাগ দলই একই কাজ করে, তবে এটি আমার পক্ষে অনুমান।

2. একটি দম্পতি লিঙ্ক যা আগ্রহী হতে পারে, সে সম্পর্কে আমি সবচেয়ে ভাল করতে পারি:

   • চতুর / পাতলা ডকুমেন্টেশন জন্য সেরা অভ্যাস
   • চতুর এবং প্রযুক্তিগত ডকুমেন্টেশন

তত্পর মধ্যে কিছু নির্দিষ্ট বিন্দু আছে ইশতেহার , যেখানে আমি নোট সহ এই এক বাতলান চাই:

বিস্তৃত ডকুমেন্টেশন ওভার সফ্টওয়্যার

এটি হ'ল ডানদিকে থাকা আইটেমগুলিতে মান থাকার সময়, আমরা বামদিকে থাকা আইটেমগুলিকে আরও মূল্যবান করি।

Comments

@ জেবি সাধারণ শব্দটি ব্যবহার করে বেশিরভাগ দল কী করে তা খুঁজে বের করা ছিল।

— গ্রম্পিমনকি

Answer 4

তারা শুধু ভয়ঙ্কর। আমি বিশ্বাস করি না চটপটি মানেই কোনও ডকুমেন্টেশন নয়। তাদের কমপক্ষে অ্যাপ্লিকেশন বর্ণনার ট্র্যাক থাকা উচিত। তাদের উইকের রফতানি পাওয়া ভাল লাগত বা অন্য কাউকে পরিষেবা ফি বাছাইয়ের অনুমতি দেওয়া হত।

এটি কিছু প্রচেষ্টা হিসাবে বিশদ নাও হতে পারে। থিয়োরিটি হ'ল, যখন কোনও সময়ের ক্রঞ্চ হয়, স্পাকগুলি আর কোনওভাবে কোডের সাথে মেলে না। সুতরাং কোডটি লেখার জন্য আপনার কাছে পর্যাপ্ত ডকুমেন্টেশন রয়েছে এবং এটিকে বিশদভাবে ব্যাখ্যা করার চেষ্টা করবেন না (কোডটি কিছু সিউডো-ভার্বালাইজড-টেক্সট / ডায়াগ্রাম-কোড এবং তারপরে আসল কোডে লেখার মতো বাছাই করুন))

Answer 5

আপনার সমস্যাটির চপলতার সাথে কোনও সম্পর্ক নেই। আপনি যে ডকুমেন্টেশন চেয়েছিলেন সেগুলি তাদের তৈরি করা উচিত। প্রকল্পটি খারাপভাবে পরিচালিত হয়েছিল।

Answer 6

বৈশিষ্ট্যগুলি, ব্যবহারকারীর গল্প এবং পরীক্ষাগুলির ক্ষেত্রে কোথাও কমপক্ষে কিছু বর্ণনা থাকতে হবে । এটি প্রকল্পগুলিতে রিডএম ফাইলগুলিতে থাকতে পারে, এটি উত্স-কোড মন্তব্যে থাকতে পারে, এটি নকশার নথিতে থাকতে পারে; এটি উপরের সমস্ত হতে পারে ... বা এটি এমআইএ হতে পারে!

Answer 7

আমার অভিজ্ঞতায় সর্বদা ডকুমেন্টেশনের দাবিতে প্রচুর লোক থাকে (আমি তাদের মধ্যে একজন হয়েছি) তবে বাস্তবে কারও কাছেই এগুলি তৈরি করার সময় বা ইচ্ছা নেই। মাঝেমধ্যে চেষ্টা রয়েছে, তবে তৈরি করা ডকুমেন্টেশনগুলি সাধারণত খুব দ্রুত পুরানো হয়ে যায় এবং সিস্টেমের আসল কার্যকারিতার সাথে সিঙ্কের বাইরে চলে যায়। এটি এমন পরিস্থিতিতে ডেকে আনে যেখানে আপনার ডকুমেন্টেশন নুন না থাকলেও এটি যাচাই করে না কারণ তারা কেবল এটি নির্ভুলতার উপর বিশ্বাস করে না।

প্রকৃত নির্ভুলতা এবং নির্ভরযোগ্য তথ্যের জন্য কোড এবং পরীক্ষাগুলি পড়তে সক্ষম হওয়ায় এটি বেশ নেমে আসে। (গ্রাহক) তার সিস্টেমটি কী করে তা আবিষ্কার করতে চায় এবং সর্বদা কোনও প্রোগ্রামারকে সাক্ষাত্কার দিতে এবং জিজ্ঞাসা করতে পারে যিনি তখন সিস্টেম সম্পর্কে কিছু তথ্য (কিছু তদন্ত সহ) উপস্থাপন করতে পারেন।

ভাল ডকুমেন্টেশন তৈরি করা তুচ্ছ-না এবং বেশ ব্যয়বহুল হতে পারে। দ্বিতীয়ত, কেউ শ্রোতাদের সম্পর্কে ভাবতে পারেন, ডকুমেন্টেশন কাদের জন্য এবং এটি সরবরাহ করার উদ্দেশ্যে কী?

Comments

আপনার মতো শব্দগুলি সত্যের পরে ডকুমেন্টেশনের উল্লেখ করছে (দয়া করে আমি ভুল হলে আমাকে ক্ষমা করুন)। সত্যের আগে ডকুমেন্টেশনে যা ঘটেছিল? হে টেম্পোরা, ও

— মোরেস