একটি কোড প্রকল্পের সাথে সম্পর্কিত ডকুমেন্টেশন সংরক্ষণের সর্বোত্তম উপায় কী?


10

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

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

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

যাইহোক এটি আমাদের দলটি নিয়ে আসল সেরা, তবে আমি সত্যিই আমার আরও ভাল (ফ্রি) সমাধানের আশা করি।


আপনার দলটি কত বড়?
জেফ

আমাদের এখনই 3-4 আছে।
ডেভিড

আপনি বিশেষত কোন সংস্করণ-নিয়ন্ত্রণ ব্যবহার করছেন। আপনি কোনও উত্স নিয়ন্ত্রণ সম্পর্কে জানেন না যেখানে আপনি এটি পরিচালনা করার জন্য ভিজুয়াল স্টুডিও ব্যবহারের সাথে আবদ্ধ হন।
আর্লজ

যেখানে আমি কাজ করি, আমরা কোড সংরক্ষণের জন্য টিএফএস এবং ডকুমেন্টেশন, পরীক্ষার পরিকল্পনা ইত্যাদির জন্য শেয়ারপয়েন্ট ব্যবহার করি
জব

4
আমি পিডিএফ-এর মতো নথিগুলি ভিএসএসে রাখার পরামর্শ দেব না। মনে মনে, আমি সত্যিই ভিএসএসে উত্স কোড রাখার প্রস্তাব দিই না।
কারসন 63000

উত্তর:


3

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

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

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


আমাদের 'উইকি' সমাধানটি হয় নেটওয়ার্ক শেয়ারের লিঙ্ক (বা নেটওয়ার্কের সরাসরি ফাইলগুলিতে লিঙ্ক করুন there সেখানে অসুবিধা নেই যে এর কোনও সংস্করণ নিয়ন্ত্রণ নেই Or অথবা আপনি উইকিতে ফাইলটি ডাউনলোড / সম্পাদনা / আপলোড করেন যা একটি 10 ধাপ যে কোনো সময় আপনি সম্পাদনা ওটা টাইপো ঠিক করতে চাই প্রক্রিয়া হয়।
ডেভিড

প্রচুর ফ্রি শেয়ারপয়েন্ট বিকল্প (এটি আরও ভাল!): সিম্পল-টু-সেটআপের জন্য Nuxeo ব্যবহার করে দেখুন। বা আরও শক্তির সাথে আলফ্রেসকো, আপনার যদি এটির প্রয়োজন হয়।
gbjbaanb

আপনার মেশিনে ইনস্টল করা গুগল অনুসন্ধান জিনিসগুলি সনাক্ত করার জন্য বিস্ময়কর কাজ করে।

3

আমার সংস্থায় যে সমাধানটি সবচেয়ে ভাল কাজ করেছে তা হ'ল একটি উইকি স্থাপন করা (আমরা মিডিয়াউইকি ব্যবহার করি)। এটি প্রচলিত উইকি এন্ট্রি থেকে শুরু করে একটি সরল "এটি একটি ..." প্লাস ওয়ার্ড নথিতে ব্যবহৃত হয় many এটি অনুসন্ধান করা খুব সহজ। আমরা ধীরে ধীরে তথ্যের একটি খুব দরকারী সঞ্চয়স্থান তৈরি করছি।


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

1

কমপক্ষে ২০০৮ সালে, আপনি সি ++ প্রকল্পের কনফিগারেশন ধরণের (প্রকল্পের বৈশিষ্ট্যগুলির মধ্যে-> সাধারণ-> প্রকল্পের ডিফল্টের অধীনে) ইউটিলিটিতে সেট করতে পারেন, সেক্ষেত্রে ভিএস এর সাথে কিছু না করে।

আপনি কি নিজের সি # ভিত্তিক সমাধানে এমন প্রকল্প ব্যবহার করার চেষ্টা করেছেন? (হতে পারে একটি সি #-প্রকল্পের কিছু একই রকম?)


0

আমি অবশ্যই একমত যে এখানে একটিও সর্বোত্তম সমাধান নেই। তবে সংস্করণ নিয়ন্ত্রণ! = সমাধান অন্তর্ভুক্ত; বেশিরভাগ সিস্টেম আইডিই এর বাইরে জিনিসগুলি পরিচালনা করতে পারে। সুতরাং কেউ বেশিরভাগ ক্ষেত্রে ডক্সকে কাছে রাখতে পারে তবে নোটাকে কাছে রাখতে পারে।

এখন, ফাইলগুলি যখনই খোলা হবে তখন শব্দের অতীতের বিরক্তিকর অভ্যাসগুলি পাওয়া আলাদা সমস্যা। । ।


0

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

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

সাবভার্সনে এমনকি ওয়েবডাভ ফোল্ডার - যেমন একটি নেটওয়ার্ক ফোল্ডার - হিসাবে সংগ্রহস্থল উন্মোচন করার ক্ষমতা রয়েছে যাতে আপনি ইউকোডল এগুলিকে একটি 'নেটওয়ার্ক ড্রাইভ' এ রাখেন তবুও সেগুলির সংস্করণ স্বয়ংক্রিয়ভাবে নিয়ন্ত্রিত থাকে।

আমি এখনও আমার ব্যক্তিগত পছন্দ হিসাবে রেডমিনে যেতে চাই।

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