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