যৌথ প্রকল্প খুলুন

এই পৃষ্ঠায় Google সিজন অফ ডক্সের জন্য গৃহীত প্রযুক্তিগত লেখার প্রকল্পের বিশদ বিবরণ রয়েছে৷

প্রকল্পের সারাংশ

ওপেন সোর্স সংস্থা:

ওপেন কালেকটিভ

প্রযুক্তিগত লেখক:

আন্না ই só

প্রকল্পের নাম:

সাধারণ সাহায্য ডকুমেন্টেশন উন্নত করুন

প্রকল্পের দৈর্ঘ্য:

স্ট্যান্ডার্ড দৈর্ঘ্য (3 মাস)

প্রকল্পের বিবরণ

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

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

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

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

প্রস্তাবনা আমি ব্যবহারকারীদের সাহায্য পৃষ্ঠাগুলির পর্যালোচনা, তাদের উপস্থাপনা এবং বর্তমান কাঠামো পুনর্বিবেচনার প্রস্তাব করছি।

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

সম্প্রদায় বন্ধনের সময়কাল (আগস্ট 1 - সেপ্টেম্বর 1, 2019): ওপেন কালেকটিভ সম্প্রদায়ের সাথে পরিচিত হওয়া! বিশিষ্ট এবং প্রারম্ভিক প্রকল্প থেকে সক্রিয় সদস্যদের সাক্ষাৎকার নেওয়া, তাদের বর্তমান ডকুমেন্টেশনের অবস্থা সম্পর্কে প্রশ্ন জিজ্ঞাসা করা (প্রতিবেদন #1)। প্রশ্ন এবং সমস্যাগুলি ট্র্যাক করতে ব্যবহৃত সমস্ত অভ্যন্তরীণ সিস্টেমের নোট নেওয়া এবং ওপেন কালেকটিভ ডক্সে (রিপোর্ট #2) নথিভুক্ত করার প্রক্রিয়া। ডকুমেন্টেশনের বর্তমান সংস্করণে সুপ্ত সমস্যাগুলির মূল্যায়ন এবং তাদের সমাধান করার জন্য একটি পরিকল্পনা প্রস্তুত করা (রিপোর্ট #3)।

সেপ্টেম্বর 2-6: সম্প্রদায় বন্ধনের সময়কালে সম্প্রদায়ের দ্বারা করা সমস্ত মন্তব্য এবং পরামর্শ বিবেচনায় নিয়ে প্রথম প্রতিক্রিয়া এবং সমন্বয় চক্র। আমাদের পরিকল্পনা কি ভাল যেতে? এটা সম্পর্কে কিছু আছে যে পরিবর্তন প্রয়োজন? (রিপোর্ট #4)

সেপ্টেম্বর 9-20: ডকুমেন্টেশনের কম জনবহুল অধ্যায় সহ ধারণার প্রমাণের বিকাশ। একটি পাবলিক স্টাইল গাইডের খসড়া (রিপোর্ট #5)।

23-25 ​​সেপ্টেম্বর: মূল্যায়নের জন্য ধারণার প্রমাণ জমা দেওয়া (বন্ধ গ্রুপ)।

সেপ্টেম্বর 26-27: লাইভে যাওয়ার আগে আমাদের ধারণার প্রমাণের কি কোনো সমন্বয় প্রয়োজন? আমরা আরো সময় প্রয়োজন? সেই অনুযায়ী সামঞ্জস্য করুন। (রিপোর্ট #6)

30 সেপ্টেম্বর - 9 অক্টোবর: ধারণার প্রমাণ লাইভ হয়। প্রতিক্রিয়ার দ্বিতীয় চক্র (পাবলিক গ্রুপ)।

অক্টোবর 10-15: ধারণা মূল্যায়ন এবং সমন্বয় চক্রের চূড়ান্ত প্রমাণ। (প্রতিবেদন #7)

অক্টোবর 16-20: কার্যকলাপ থেকে ছোট বিরতি [1]।

অক্টোবর 21 - নভেম্বর 23: পাবলিক স্টাইল গাইড চূড়ান্ত (রিপোর্ট #8)। সমস্ত ব্যবহারকারীর ডকুমেন্টেশন পৃষ্ঠাগুলিতে স্টাইল গাইডে উপস্থিত সমস্ত নির্দেশাবলীর প্রয়োগ (রিপোর্ট #9)। সম্পাদিত সমস্ত ক্রিয়াকলাপ মূল্যায়ন এবং সম্প্রদায়ের জন্য আরও সুপারিশের প্রতিবেদন করুন (প্রতিবেদন #10)।

অনুরোধের ভিত্তিতে প্রকল্পের মেয়াদ বাড়ানো যেতে পারে।

[১]: আমার সিজন অফ ডক্স অ্যাপ্লিকেশনের আগে ভ্রমণের পরিকল্পনা করা হয়েছে।

বিতরণযোগ্য - সম্পাদিত ক্রিয়াকলাপের উপর দশটি পাবলিক রিপোর্ট - একটি পাবলিক স্টাইল গাইড ওপেন কালেক্টিভ এবং বাইরের অবদানকারী উভয়ই ব্যবহার করতে পারে - ব্যবহারকারীর ডকুমেন্টেশন পৃষ্ঠাগুলি পরিবর্তিত