প্রথমে প্রকাশ করবেন নাকি নথি আগে?


23

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

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

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

গ্রাহক কি এই পরিস্থিতিতে ঠিক আছে? বিদ্যমান ব্যবহারকারীদের জন্য কি দুর্দান্ত, স্ট্রেট-ফরোয়ার্ড বৈশিষ্ট্যটি নতুন ব্যবহারকারীদের জন্য শক্তিশালী ডকুমেন্টেশনের চেয়ে বেশি হওয়া উচিত?


আপডেট: বাহ, অনেক দুর্দান্ত, উচ্চ মানের প্রতিক্রিয়া! প্রকল্প এবং এর ব্যবহারকারীদের উভয়কে কীভাবে ইন্টারঅ্যাক্ট করা এবং সহায়তা করা উচিত সে সম্পর্কে আরও ভাল ধারণা পেতে আপনি আমাকে সত্যই সহায়তা করেছেন। অসংখ্য ধন্যবাদ!


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

3
প্রকল্পের উপর নির্ভর করে আপনি নতুন সংস্করণটি "বিটা" বা "পূর্বরূপ" হিসাবে আলাদা শাখায় প্রকাশ করতে পারেন।
কোডসইনচওস

2
কোন ধরনের ডকুমেন্টেশন - শেষ ব্যবহারকারীদের ডকুমেন্টেশন বা সোর্স কোড ডকুমেন্টেশন? বা আপনার প্রকল্পটি এমন কোনও প্রকল্প যেখানে তাদের মধ্যে কোনও পার্থক্য নেই?
ডক ব্রাউন

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

@ ডকব্রাউন এই ক্ষেত্রে এটি ব্যবহারকারীর ডকুমেন্টেশন। উত্স কোড ডকুমেন্টেশন শুধুমাত্র আমার জন্য দরকারী হবে।
সাইবারবিত

উত্তর:


45

সরল: একটি বিটা সংস্করণ প্রকাশ করুন! তারপরে ডকুমেন্টেশন হয়ে গেলে, নতুন সংস্করণটির চূড়ান্ত প্রকাশ করুন।

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

মূলত, প্রত্যেকেই জয়ী হয়।


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

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


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

আমি এখানে জিজ্ঞাসা করার আগে আমি আসলে একটি বিটা রিলিজ বিবেচনা করেছি! এই ধারণার সমস্যাটি হ'ল আমি যে চ্যানেলগুলি ব্যবহার করি তা আমাকে বিভাজন প্রকাশের জন্য একটি সম্পূর্ণ আলাদা অ্যাপ লিখতে বাধ্য করে। আমি একটি পৃথক বিটার দিকে কাজ শুরু করেছিলাম, তবে এটির রসদগুলি কঠিন এবং প্রকল্পের এই পর্যায়ে এটি উপযুক্ত বলে মনে হচ্ছে না।
সাইবারবিত

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

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

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

15

যদি আমি আপনাকে সঠিকভাবে বুঝতে পারি তবে আপনি এই প্রকল্পটি আপনার নিখরচায় এবং কোনও টাকার বিনিময়ে করছেন । যদি এটি হয় তবে দয়া করে আপনার যা ভাল মনে হয় তা করুন (ব্যবহারকারীরা অপেক্ষা করুন, আপনার সময়ে নথি করুন)। আপনার "ব্যবহারকারীদের" থেকে চাপ অনুভব করা উচিত নয়। অনেকে ইন্টারনেটে এটি সম্পর্কে লিখেছিলেন (চাপটি অনুভব করে এমন বড় FLOSS লেখক এবং অবদানকারী)।

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


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

4

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

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

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

কিছু বিপণনের টিপস আপনাকে ব্যবহারকারীর প্রত্যাশাগুলিতে ভারসাম্য বজায় রাখতে এবং আপনার ব্র্যান্ডটি বাড়িয়ে তুলতে পারে। এটি সত্যিই নির্ভর করে যে আপনি এ পর্যন্ত তৈরি করেছেন এমন অ্যাপ্লিকেশন এবং কর্মপ্রবাহের উপর নির্ভর করে তবে আপনি আপনার নতুন সংস্করণে স্বাগত পর্দা রাখতে পারেন এবং অ্যাপ্লিকেশনটির মধ্যে আপনি লিঙ্ক সরবরাহ করে বা অ্যাপের অভ্যন্তরে ভিডিওগুলি প্লে করে ভিডিওগুলি প্রদর্শন করতে পারেন।


3

কেবলমাত্র এই নির্দিষ্ট উদাহরণের জন্যই নয় তবে সাধারণ কর্মপ্রবাহের জন্যও কিছু যুক্ত করতে:

ডকুমেন্টেশন আপনার হতে পারে definition of done, তবে ডকুমেন্টেশন বেশিরভাগ সময় ন্যূনতম ব্যবহারযোগ্য পণ্য (এমভিপি) এর বাইরে।

না শুধুমাত্র গ্রাহক সবসময় সঠিক। যদি এটি বাণিজ্যিক পণ্য হয় তবে মুক্তি দেওয়া অনেক ব্যবসায়ের মূল্য হতে পারে এবং এটি একটি পরম অগ্রাধিকার।

মালিক ব্যবসায়ের মূল্য সংজ্ঞায়িত করেন (যা আপনি আমি গণনা করি), সুতরাং আপনার গ্রাহকদের জন্য পণ্য হিসাবে আরও মূল্যবান কী?

এছাড়াও ডকুমেন্টেশন ছাড়া মুক্তি ঝুঁকি আছে?

উদাহরণস্বরূপ প্রতিযোগিতা ; যদি প্রতিযোগিতা আপনার আগে এই দুর্দান্ত বৈশিষ্ট্য প্রকাশ করে তবে আপনি সম্ভবত কিছু ব্যবহারকারীকে হারাতে পারেন।

নিজেকে বা পণ্য মালিককে এই প্রশ্নগুলি জিজ্ঞাসা করুন এবং আপনার উত্তর পরিষ্কার হবে।


2

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


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

@ আরবার্টার্থে একটি বর্তমান ব্যবহারকারী বেস ইঙ্গিত করা হয়েছিল। সুতরাং আমি অনুমান করি তারা কিছু অপ্রকাশিত বিটা কিছু বা অন্য ব্যবহার করছে।
candied_orange

একটি বিদ্যমান প্রকাশ আছে, যা এর আওয়াজ থেকে আন্ডার-ডকুমেন্ট হওয়া সত্ত্বেও স্থিতিশীল হিসাবে বিবেচিত হয়।
jpmc26

2

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

আপনার ব্যবহারকারীরা ডকুমেন্টেশনের মাধ্যমে নতুন বৈশিষ্ট্য চান, তবে তারা কী উপলব্ধি করতে পারে যে সহায়তা সরবরাহ, বাগগুলি ঠিক করতে, প্যাচগুলি ছেড়ে দেওয়ার জন্য আপনার প্রাপ্যতা হ্রাস পেতে পারে?

আমি যখন আপনাকে যা করতে হবে তা যখন আমার প্রশ্নটি সহ একটি ইমেল প্রেরণ করা হয় আমি যদি নির্দেশগুলি পড়তে বিরক্ত না করি তবে আমি কেন নতুন বৈশিষ্ট্যগুলির মাধ্যমে ডকুমেন্টেশন চাইব?


-1

যদি প্যাকেজটি প্রকাশের জন্য প্রস্তুত থাকে তবে গ্রাহক / ক্লায়েন্টকে ছেড়ে দিন এবং ডকুমেন্টেশনের কাজ শুরু করুন। ক্লায়েন্টের সাথে যোগাযোগ করা ভাল, যখন আপনি ডকুমেন্টেশন ভাগ করবেন যা তাদের স্থাপনা বৈশিষ্ট্যগুলি বুঝতে সহায়তা করে।

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