এই পৃষ্ঠায় Google সিজন অফ ডক্সের জন্য গৃহীত প্রযুক্তিগত লেখার প্রকল্পের বিশদ বিবরণ রয়েছে৷
প্রকল্পের সারাংশ
- ওপেন সোর্স সংস্থা:
- এইচপিএক্স
- প্রযুক্তিগত লেখক:
- rstobaugh
- প্রকল্পের নাম:
- বিদ্যমান HPX ডকুমেন্টেশন সম্পাদনা ও প্রবাহিত করুন
- প্রকল্পের দৈর্ঘ্য:
- স্ট্যান্ডার্ড দৈর্ঘ্য (3 মাস)
প্রকল্পের বিবরণ
আমার প্রস্তাব বর্তমান HPX ডকুমেন্টেশনের বিষয়বস্তু সম্পাদনা এবং প্রবাহিত করা। আমার প্রস্তাবটি একটি আদর্শ মেয়াদী (তিন মাস) প্রকল্পের জন্য যা STE||AR গ্রুপের ম্যানুয়ালটির দুটি অধ্যায় সংশোধন করার উপর দৃষ্টি নিবদ্ধ করে: ""HPX বিল্ড সিস্টেম এবং লঞ্চিং"" (1) এবং ""HPX অ্যাপ্লিকেশন কনফিগার করা"" (2) .
""এইচপিএক্স বিল্ড সিস্টেম এবং লঞ্চিং"" অধ্যায়ে বেশ কয়েকটি ব্যাকরণগত ত্রুটি রয়েছে এবং এতে বিভ্রান্তিকর ভাষা এবং "CMake" এর মতো পদগুলির অসঙ্গত ক্যাপিটালাইজেশন রয়েছে৷ অধিকন্তু, এতে পুনরাবৃত্ত তথ্য রয়েছে, যা আমি প্রয়োজন অনুসারে পুনর্বিন্যাস, একত্রীকরণ এবং ছাঁটাই করার পরিকল্পনা করছি। যদিও ""এইচপিএক্স অ্যাপ্লিকেশন কনফিগার করা"" অধ্যায়ে কয়েকটি ব্যাকরণগত ত্রুটি রয়েছে যা সমাধান করা দরকার, এই অধ্যায়ের জন্য আমার প্রাথমিক উদ্বেগ হল এর ব্যবহারকারী বন্ধুত্ব। অধ্যায়ে তিনটি প্রধান নকশা সমস্যা রয়েছে যা আমি সমাধান করার পরিকল্পনা করছি:
কিছু শিরোনাম পাঠ্যের মধ্যে সমাহিত করা হয়েছে, এটি অধ্যায়ের মধ্য দিয়ে স্কিম করা কঠিন করে তোলে। বর্তমানে, প্রতিটি টেবিলের উদ্দেশ্য বোঝার জন্য একজন ব্যবহারকারীকে ম্যানুয়ালটি সাবধানে পড়তে হবে। বেশিরভাগ ব্যবহারকারীরা নির্দেশিকা ম্যানুয়ালগুলির সাথে কীভাবে ইন্টারঅ্যাক্ট করেন তা নয়, বিশেষ করে যদি তারা ইতিমধ্যে বিষয়বস্তুটি আগে পড়ে থাকে। পরিবর্তে, আমি নিশ্চিত করার পরিকল্পনা করছি যে প্রতিটি টেবিলের একটি পরিষ্কার, স্বতন্ত্র শিরোনাম রয়েছে, যা ব্যবহারকারী পাঠ্যের মাধ্যমে স্ক্রোল করলে সহজেই দেখা যাবে।
একটি নির্দিষ্ট শিরোনামের অধীনে বিভিন্ন বৈশিষ্ট্য তালিকাভুক্ত করার সময়, বৈশিষ্ট্যগুলি একটি যৌক্তিক ক্রম অনুসরণ করে না। যদিও বৈশিষ্ট্যগুলি একটি সাধারণ থিমের অধীনে একত্রিত করা হয়, সেখানে কোনও উপগোষ্ঠী নেই, যা তথ্যকে ছড়িয়ে ছিটিয়ে অনুভব করে। উদাহরণ স্বরূপ, একজন ব্যবহারকারী এমন বেশ কয়েকটি বৈশিষ্ট্যের সম্মুখীন হতে পারে যা স্থানীয়তার সাথে কাজ করে, কয়েকটি যেটি অন্য বিষয় নিয়ে কাজ করে, তারপরে অন্যটি স্থানীয়তার সাথে সম্পর্কিত। শিরোনামের অধীনে অভ্যন্তরীণ কাঠামোর এই অভাব একটি নির্দিষ্ট উপবিষয়ক সমস্ত তথ্য সনাক্ত করা কঠিন করে তোলে। অতএব, আমি প্রতিটি শিরোনামের অধীনে একই ধরনের তথ্যকে আরও স্পষ্টভাবে গোষ্ঠীবদ্ধ করতে বেশ কয়েকটি চার্ট পুনর্গঠন করার পরিকল্পনা করছি।
নির্দিষ্ট নির্দেশাবলী সম্পূর্ণরূপে বোঝার জন্য ব্যবহারকারীদের বিভাগগুলির মধ্যে (বা দুটি পৃথক ট্যাবে ম্যানুয়ালটি খুলতে) পিছনে পিছনে নেভিগেট করতে বাধ্য করা হয়। এমন কিছু পয়েন্ট রয়েছে যেখানে অধ্যায়টি ব্যবহারকারীকে পূর্ববর্তী বিভাগের মধ্যে একটি একক বাক্যে এমনভাবে নির্দেশ করে যা পাঠককে সঠিক নির্দেশনা বোঝার জন্য একটি হাইপারলিংক স্ক্রোল করতে বা অনুসরণ করতে বাধ্য করে, কারণ ম্যানুয়ালটি অস্পষ্ট ভাষা ব্যবহার করে যেমন "এই পদক্ষেপটি আগে থেকে তৈরি করা হয়েছে ধাপ 11" পূর্ববর্তী বিভাগে। যদিও এই পদ্ধতিটি পুনরাবৃত্তি দূর করে, এটি নির্দেশাবলী বোঝা কঠিন করে তোলে, কারণ এগুলি এমন কাজ যা একটি নির্দিষ্ট ক্রমানুসারে তৈরি করা প্রয়োজন। পরিবর্তে, আমি আরও নির্দিষ্ট শব্দ অন্তর্ভুক্ত করার প্রস্তাব করছি যাতে ব্যবহারকারীদের বিভাগ বা নথির মধ্যে পরিবর্তন করে তাদের পড়ার প্রক্রিয়াকে বাধাগ্রস্ত করতে না হয়।
যদি আমি স্ট্যান্ডার্ড টাইমলাইন শেষ হওয়ার আগে এই বিভাগগুলি সম্পূর্ণ করি, তবে আমি "কেন HPX?" পরিষ্কার করতে চাই (3) STE||AR গ্রুপের ব্যবহারকারী ডকুমেন্টেশনের অধীনে পৃষ্ঠা। এই পৃষ্ঠায় পুনরাবৃত্তিমূলক পরিচায়ক বিষয়বস্তু রয়েছে, যা আমি একত্রিত করার আশা করি এবং এতে অসঙ্গতি রয়েছে (বিশেষ করে জারগনের) এবং ভয়েস, যা এটিকে একটি বিচ্ছিন্ন অনুভূতি দেয়। আমার লক্ষ্য হবে STE||AR গ্রুপের কাজের আরও একীভূত, সামঞ্জস্যপূর্ণ ভূমিকা তৈরি করা।