পণ্য নকশার সিদ্ধান্তের পিছনে যৌক্তিকতা রেকর্ড করার কার্যকর উপায় কী?


30

আমাদের সংস্থায়, আমরা কোনও পণ্য ডিজাইনের নথি ব্যবহার করি না। আমাদের মোট তিনজন কর্মী রয়েছেন তাই সমস্ত পণ্য নকশার আলোচনা ব্যক্তিগতভাবে বা স্ল্যাকের সাথে ঘটে। (আমরা বেসিক স্ল্যাক প্যাকেজেও আছি যা কেবলমাত্র সাম্প্রতিক বার্তাগুলি দেখার অনুমতি দেয়))

আমাদের পণ্য এখনও প্রাথমিক পর্যায়ে রয়েছে এবং আমরা প্রায়শই মাস আগে সিদ্ধান্ত নেওয়া নকশার উপাদানগুলিতে আবার ঘুরে দেখি।

আমরা যে সমস্যাটি হতাশাজনকভাবে ঘন ঘন ঘন ঘন ঘন ঘন ঘন ভিত্তিতে ভোগ করি তা হ'ল কেন পণ্য ডিজাইনের সিদ্ধান্ত নেওয়া হয়েছিল। এই ফলাফল কয়েক ঘন্টার মধ্যে একই গ্রাউন্ডে retreading নষ্ট।

ডিজাইনের সিদ্ধান্তের পিছনে যুক্তিগুলি কীভাবে আমরা কার্যকরভাবে রেকর্ড করতে পারি?

আমাদের কর্মপ্রবাহ পাইভোটাল ট্র্যাকারের উপর ভিত্তি করে। আমার কাছে ঘটে যাওয়া একটি সমাধান হ'ল ব্যবহারকারীর গল্পের মতামত হিসাবে সমস্ত প্রাসঙ্গিক নকশার সিদ্ধান্তের জন্য যুক্তি রেকর্ড করা, তবে এটি বিশ্বাসযোগ্য নয় বলে মনে হয়।

100% পরিষ্কার হতে: আমি কোড ডিজাইনের কথা বলছি না। আমি কোডটি অনুধাবন করা পণ্যটির ডিজাইনের কথা বলছি। অন্য কথায়, আমি এই জাতীয় সিদ্ধান্তের বিষয়ে কথা বলছি না "একাধিক উত্তরাধিকারের চেয়ে রচনাটি ব্যবহার করে কি আমাদের এই শ্রেণিটি গঠন করা উচিত?" আমি এই জাতীয় সিদ্ধান্তের কথা বলছি "লগ ইন করতে সক্ষম হওয়ার আগে আমাদের কোনও ব্যবহারকারীর তাদের ইমেল ঠিকানাটি নিশ্চিত করা উচিত?"

ডকুমেন্টেশনের উদ্দেশ্য হ'ল ব্যবসায়ের সিদ্ধান্ত কেন নেওয়া হয়েছিল তার একটি রেকর্ড দেখতে দেওয়া, একই বিষয়গুলি সম্পর্কে আরও সিদ্ধান্ত নিতে সহায়তা করা to


13
আপনি যদি মনে করেন আপনার কোনও ফর্ম ডিজাইন ডকুমেন্টের দরকার আছে তবে কেন কেবল একটি নকশা নথি তৈরি করবেন না?
মেটাফাইট

আমি অনুমান করি যে অনুমানগুলি প্রথম অনুমানে গদ্য, লিখিত গদ্য হিসাবে লিপিবদ্ধ করা হবে। তাদের জন্য উদ্দেশ্য পাঠক কে?
লরেন্ট এলএ রিজ্জা

আপনি কেন বলছেন যে পিভোটালের ব্যবহারকারী গল্পগুলিতে এটি রেকর্ডিং অবিশ্বাস্য বলে মনে হচ্ছে? আমি কখনই সেই সফ্টওয়্যারটি ব্যবহার করি নি, তবে টিকিট বাড়ানোর প্রেরণা রেকর্ড করার জন্য সাধারণত টিকিটই ভাল জায়গা। শুধু "ইমেল ঠিকানা নিশ্চিত করার জন্য ব্যবহারকারী প্রয়োজন" প্রবেশ করান না, "ইমেল ঠিকানা নিশ্চিত করার জন্য ব্যবহারকারীকে প্রয়োজন enter প্রবেশ করুন This এটি সাহায্য করে কারণ ..." আপনি কি বলছেন এটি বিশ্বাসযোগ্য নয় কারণ আপনি এটি করতে বিরক্ত করবেন না (যেমন আপনি এমন একটি প্রক্রিয়া চান যা জোর করে আপনি সঠিক কাজটি করবেন), বা অবিশ্বাস্য কারণ পুরানো পিভোটাল গল্পগুলি একটি ব্ল্যাকহোলের মধ্যে অদৃশ্য হয়ে যায় এবং আপনি সেগুলি খুঁজে পাবেন না, বা অন্য কোনও সমস্যা আছে?
স্টিভ জেসোপ

লেখক কারা এবং এই ডকুমেন্টেশনের ভোক্তা কারা? আমার কাছে মনে হচ্ছে "ব্যবসা" লেখক এবং সবাই কি এর পাঠক? এটা কি সঠিক হবে? (আমি পেয়েছি যে আপনি এখনই ছোট, তবে আপনি যদি বড়
হতেন

আমি পরামর্শ দেব "লগ ইন করতে সক্ষম হওয়ার আগে আমাদের কোনও ব্যবহারকারীর তাদের ইমেল ঠিকানাটি নিশ্চিত করা উচিত?" ধরনের সিদ্ধান্ত গ্রহণযোগ্যতা মানদণ্ডের অধীনে হওয়া উচিত।
কুমারডস

উত্তর:


26

আপনি নকশার সিদ্ধান্তগুলির পিছনে যুক্তিগুলি সেগুলি লিখে রেকর্ড করুন। আদর্শ হিসাবে আইটেমটি সিদ্ধান্তের সাপেক্ষে নিকটবর্তী (যা কোনও "ব্যবহারকারী গল্প" নয় - ব্যবহারকারীর গল্পগুলি কীভাবে কার্যকর করা যায় না সেগুলি বর্ণনা করা হয়) implemented

বিশেষ করে কি মন্তব্য রেকর্ড - জন্য তৈরি করা হয় কেন কোড বা কাঠামো কেমন লাগে একটি নির্দিষ্ট টুকরা মত এটা আছে (এবং আমি একচেটিয়াভাবে কোড মন্তব্য বলছি না)। আপনার ডিজাইনের বিষয় যদি কোনও ফাংশন হয় তবে ফাংশনে একটি সূচনা মন্তব্য করুন। যদি এটি একটি শ্রেণি হয় তবে যৌক্তিকতা সম্পর্কে ক্লাসের শুরুতে একটি মন্তব্য করুন। আপনার যদি ক্লাসগুলির একগুচ্ছ থাকে যা সকলের একই কাঠামো অনুসরণ করা উচিত তবে সেই ক্লাসগুলি থাকা প্যাকেজে একটি পৃথক নকশা নথি ("রিডমে" ফাইলের মতো) যুক্ত করুন। আপনার ডিজাইনের বিষয় যদি কোনও ইউএমএল চিত্র হয় তবে চিত্রের বর্ণনা বিভাগে মন্তব্য যুক্ত করুন।

আইএমএইচও ডিজাইনের নথিগুলির মান থাকতে পারে তবে তারা যে আইটেমটি বর্ণনা করেছেন সেগুলি থেকে তারা খুব "দূরে" জিনিসগুলি বর্ণনা করলে তারা খুব দ্রুতই বেমানান হয়ে যায়। সুতরাং আমার সুপারিশটি হ'ল যেকোন ডিজাইন ডকুমেন্টেশন যতটা সম্ভব নকশা করা আইটেমের কাছাকাছি রাখা put

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


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

5
@ হেনরেবোথা: ডিজাইন কী, কী হতে পারে বা কী হওয়া উচিত সে সম্পর্কে আপনার থেকে আমার আলাদা ধারণা রয়েছে বলে মনে হয়। কোড ডিজাইন। কোডের গঠন হ'ল নকশা। ব্যবহারকারীর ইন্টারফেসের গঠন হ'ল নকশা। কোড বা ক্লাসের মেটা স্ট্রাকচারগুলি হ'ল নকশা। "ব্যবহারকারীর ওয়াই অ্যাকাউন্ট সেটিংস দেওয়া উচিত" এর মতো একটি প্রশ্নের উত্তর আমার কাছে এমন কিছু শোনাচ্ছে যা আপনি নিজের সফ্টওয়্যারটিতে কোথাও হার্ডওয়ার করতে চান না - এটি কনফিগারযোগ্য প্রয়োজনীয়তার মতো শোনাচ্ছে। কিভাবে আপনি যে প্রয়োজন বাস্তবায়ন কোডে তাই আপনি এটি কোথাও আপনার কোডে মন্তব্য করতে পারবেন হয়তো একটি নকশা সিদ্ধান্ত।
ডক ব্রাউন

2
@ এনেরেবোথা: আপনি যদি অ্যাকাউন্টে সেটিংস ওয়াইয়ে এক্সকে কঠোরভাবে অনুমতি দিয়ে থাকেন তবে সেই সিদ্ধান্ত থেকে কোড প্রভাবিত হবে। কিছু কোড যা অনুমতিগুলি নিয়ন্ত্রণ করে, কিছু কোড যা অ্যাকাউন্ট সেটিংস পরিচালনা করে, কিছু ইউআই কোড, কিছু নিয়ামক কোড। সুতরাং এই সমস্ত জায়গায় কোডটিতে একটি মন্তব্য থাকা উচিত। অবশ্যই, পুনরাবৃত্তিগুলি এড়াতে, সমস্ত মন্তব্য পৃথক নকশার নথির সাথে সম্পর্কিত হতে পারে, যদি এর পিছনে কোনও যুক্তি থাকে যা অনেকগুলি পৃথক স্থানকে প্রভাবিত করে (যেমন আমি আমার উত্তরে বলেছি) ..
ডক ব্রাউন

1
আমি বিতর্ক করছি না যে নকশা সিদ্ধান্ত কোড প্রভাবিত করে। অবশ্যই ডিজাইনের সিদ্ধান্তগুলি কোডকে প্রভাবিত করে। তারপরেও এর অর্থ এই নয় যে পণ্যগুলির নকশার সিদ্ধান্তগুলি রেকর্ড করার জন্য মন্তব্যগুলি সঠিক জায়গা।
হেনরেবোথা

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

8

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

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

এখন আপনার সমস্যা আছে। আপনি খুঁজে পেয়েছেন যে স্কিউশওয়্যারটি যথাযথভাবে যথোপযুক্ত ধারন করে না। একটি সমস্যা আছে তা উপলব্ধি করার জন্য এবং এটি সমাধান করা দরকার তা সনাক্ত করার জন্য আপনার পক্ষে ভাল! এটি সর্বদা সহজ পদক্ষেপ নয়! সুতরাং আমরা পুরোপুরি নিশ্চিত হয়েছি যে সমাধানটি সেই যুক্তিটির কিছুটি ডকুমেন্টেশনে অফলোড করা। তবে, এটি যথেষ্ট নয়। আমরা ধাঁধাটির দ্বিতীয়ার্ধটিকে কখনই ভুলতে পারি না, যখন আপনার কোনও সিদ্ধান্ত নেওয়ার দরকার পড়ে স্কোয়াশওয়াইয়ারে যুক্তিটি পুনরায় লোড করা হয়। আমি প্রচুর দল দেখেছি যা পাগলের মতো সমস্ত কিছু নথি করে, তবে সামগ্রীটি ভাল সিদ্ধান্ত নিতে সহায়তা করার জন্য আসলে সংগঠিত হয় না, তাই তারা লিখিত থাকা সত্ত্বেও যুক্তিগুলি ভুলে যায়

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

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

চটপটে যাওয়ার সময়।

আমার পরামর্শটি হ'ল আপনার ডকুমেন্টেশন প্রক্রিয়াটি উন্নত করার জন্য একটি চতুর প্রচেষ্টা শুরু করা: স্কুইশওয়্যার থেকে ডকুমেন্ট এবং স্কুইশওয়াইয়ারে ফিরে পুরো নয় গজ। সামনে চিনুন যে আপনি কিছু তথ্য হারাবেন কারণ আপনার প্রক্রিয়াটি নিখুঁত নয়, তবে এটি ঠিক আছে কারণ আপনি এখনও প্রক্রিয়াটি বের করার চেষ্টা করছেন! আপনি যদি একটি আকার তৈরি করার চেষ্টা করেন তবে সমস্ত সমাধান মাপসই হয়।

কয়েকটি বিশেষ টিডবিট আমি দেখেছি: * অনানুষ্ঠানিক ডকুমেন্টেশন অন্বেষণ করুন। আনুষ্ঠানিক ডকুমেন্টেশন দুর্দান্ত তবে এটি সময় সাপেক্ষ। ডকুমেন্টেশনের অন্যতম উদ্দেশ্য হ'ল বিকাশকারী স্কুইশওয়্যার থেকে তথ্য প্রকাশ করা এবং এটি কাগজে রাখা। অনানুষ্ঠানিক ডকুমেন্টেশন এগুলি করার জন্য সর্বনিম্ন ব্যয় রাখে।

  • অবিশ্বাস্য ডকুমেন্টেশন ফর্ম্যাটগুলি গ্রহণ করুন। কিছুই ঠিক হবে না প্রথমবার। ডেটা পাওয়া এবং এটি কীভাবে পরে নির্ভরযোগ্য করা যায় তা নির্ধারণ করা ভাল। উদাহরণস্বরূপ, আপনি আপনার যৌক্তিকতাগুলি <ব্রিটিশ> </rationale> ব্লক বা অনুরূপ কিছুতে নথিভুক্ত করতে পারেন, যা পরে সেই ডেটা সংগ্রহ করা সহজ করে। ব্যবহারকারীর গল্পে রেশনালগুলি সংরক্ষণ করা এখনই ঠিক আছে!
  • প্রতিষ্ঠানের মান কখনই ভুলে যাবেন না। দল হিসাবে আপনি কীভাবে ডকুমেন্টেশনে যৌক্তিক বিষয়গুলি অনুসন্ধান করতে চান তা সন্ধান করুন এবং তাতে নথিভুক্ত করার চেষ্টা করুন। প্রতিটি দলে আলাদা প্রক্রিয়া থাকবে। আমার একটি টিমে আমরা এখনই টিকিটটি খুঁজে পাইনি যে এর ঠিক তত্ক্ষণাত যুক্তিযুক্ত ছিল। আমরা যা করতে পারি তা হল কোডের একটি লাইন যা গুরুত্বপূর্ণ, svn blameএটি কখন পরিবর্তিত হয়েছে এবং কেন, তারপরে টিকিটের দিকে নজর দিন do একবার আমরা সেখানে উপস্থিত হয়ে গেলে, আমরা সাধারণত আমাদের প্রয়োজনীয় যুক্তিগুলি টিকিটটিতে রেখে দিয়েছিলাম। এটি কেবল আমাদের জন্য কাজ করেছে, আপনার জন্য কী কাজ করে তা সন্ধান করুন।
  • জৈব ডকুমেন্টেশন সময়ের সাথে বাড়তে পারে। ডেভেলপারদের পক্ষে এটি জানা খুব বিরল যে কোন দিন এগুলি লেখার জন্য প্রয়োজনীয় যুক্তিগুলি সবচেয়ে গুরুত্বপূর্ণ। আমরা সাধারণত খুঁজে বের করি যেগুলির পরে গুরুত্বপূর্ণ ছিল। আপনার যদি ডকুমেন্টেশনের জন্য গ্রুমিং প্রক্রিয়া থাকে যা বিকাশকারীদের তাদের নিজস্ব ছোট্ট যুক্তি সম্পর্কিত পরিচালনা করার অনুমতি দেয় তবে গুরুত্বপূর্ণগুলি পৃষ্ঠায় উঠে যাবে to আরও গুরুত্বপূর্ণ, যৌক্তিক পরিবর্তন হতে পারে। আপনি বুঝতে পারেন যে দুটি পৃথক পরিবর্তন, দুটি পৃথক যুক্তি সহ, সত্যই সর্বোত্তমভাবে একক যুক্তি দ্বারা বর্ণিত হয়েছিল যা উভয়ের পক্ষে কার্যকর হয়। আপনার এবং সিদ্ধান্তের মধ্যে এখন কম সামগ্রী রয়েছে!

0

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


2
আর্কিটেকচার এবং উচ্চ স্তরের সিদ্ধান্ত - ঠিক আছে। এপিআই ডক্স - না! আমাদের সংস্থার কিছু লোক অতীতে এটি চেষ্টা করেছিল এটি সর্বদা এক রকম হয় - নিম্ন স্তরের ডক্স কোডের সাথে সিঙ্কের বাইরে চলে যায়। উইকিস না ইন্টারঅ্যাক্ট ভাল VCS সঙ্গে, মানুষ ভুলে গেছ অথবা এটি ইত্যাদি আপডেট করার এপিআই ডক্স অন্তর্গত জন্য সময় নিতে না কোডে ফাংশন তারা বর্ণনা সামনে। আপনার যদি মনে হয় আপনার আপনার ইন্ট্রনেটে এগুলি প্রয়োজন, সেখান থেকে তাদের এক্সট্রাক্ট করার জন্য ডোজিজেনের মতো এইচটিএমএল জেনারেটর ব্যবহার করুন। তবে নিজেই অনুগ্রহ করুন এবং কোনও উইকিতে ম্যানুয়ালি আলাদাভাবে এগুলি বজায় রাখবেন না।
ডক ব্রাউন

3
আমি দৃly়ভাবে বিশ্বাস করি যে সমস্ত ডিজাইনের যুক্তি উত্স কোড সংগ্রহস্থলের মধ্যে লেখা উচিত। অন্য কোনও জায়গা এবং তারা কেবল সিঙ্ক থেকে বেরিয়ে আসে না, তারা তাদের ইতিহাসও মনে রাখে না।
56

একটি সমাধান যে কাজ করে ... ঠিক আছে তাহলে।
zerobandwidth

0

কোডারের দৃষ্টিকোণ থেকে এটি সম্পর্কে ভাবুন যে 12 মাসের মধ্যে এটি পরিবর্তন করতে বলা হবে।

আপনি যদি এই ব্যবসায়ের নিয়মটিকে একটি স্বয়ংক্রিয় পরীক্ষার হিসাবে যুক্ত করেন তবে পরিবর্তনটি করা হবে এবং তারপরে আপনি ব্যর্থ পরীক্ষার থেকে পরস্পরবিরোধী প্রয়োজনীয়তাটি পেয়ে যাবেন (এবং আশা করি আপনি আসল প্রয়োজনীয়তার সাথে সম্পর্কিত ব্যক্তিকে এবং এটি নির্দিষ্ট করার কারণ হিসাবে তাদের ক্যাপচার করবেন)।

আমি ডিজাইনের ডকটিকে (যেখানে আপনি নিজের বিপিএমএন ডায়াগ্রাম, ট্রানজেকশন ডায়াগ্রাম, এমনকি হোয়াইটবোর্ডের একটি ফটো ইত্যাদি রেখেছেন) কোডটিকে সাদৃশ্য হিসাবে দেখায়, কেবল একটি নির্বাহযোগ্য ফর্ম ... যার অর্থ আপনি কী চেষ্টা করছেন রেকর্ড একটি কোড মন্তব্য অনুরূপ, কিন্তু একটি (পরীক্ষামূলক) প্রয়োজনীয়তা নকশায় সামনের দিকে নির্দিষ্ট। সম্ভবত আপনি যদি চালিত দোকান হন তবে আপনি এখনও আপনার কোডটি ডিজাইন করেন, আপনি এটি লেখার আগে শেষ মুহুর্তে এটি করুন do অন্যান্য সমস্ত প্রকল্পের নথি সহ এটি কোড-বেসে রাখুন।

আপনি যা করেন না কেন, এটি অনুসন্ধানযোগ্য যে কোনও উপায়ে সংরক্ষণ করা হয়েছে তা নিশ্চিত করুন (উদাহরণস্বরূপ আপনি নতুন প্রমাণ উল্লেখ করার সময় "প্রমাণীকরণ" সম্পর্কিত সমস্ত ব্যবসায়ের নিয়মগুলি টানতে চাইতে পারেন)।


0

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

এই বলে যে কিছু ডিজাইনের জন্য মানুষের মস্তিষ্কে বাস করা ঠিক আছে যা বিকাশকারীরা এগিয়ে যায় এবং বিভিন্ন চাকরি খুঁজে পায় এবং সেই মূল্যবান তথ্য তাদের সাথে নিয়ে যায়।

আপনার কোডটি একমাত্র ডিজাইনের ডকুমেন্টেশন হ'ল ম্যাগনিফাইং গ্লাস ব্যবহার করে শহর ঘুরে আপনার পথ সন্ধান করার মতো। একটি মানচিত্র অনেক বেশি কার্যকর (দুর্ভাগ্যক্রমে উত্স কোডের জন্য কোনও জিপিএস সমতুল্য নেই)।

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

আমাদের সাইট ব্যবহার করে, আপনি স্বীকার করেছেন যে আপনি আমাদের কুকি নীতি এবং গোপনীয়তা নীতিটি পড়েছেন এবং বুঝতে পেরেছেন ।
Licensed under cc by-sa 3.0 with attribution required.