ক্লাউড নেটিভ বাংলা স্টাইল গাইড

 ক্লাউড নেটিভ শব্দকোষ CNCF সংগ্রহস্থলের ডিফল্ট স্টাইল গাইড অনুসরণ করে। উপরন্তু, এটি নিম্নলিখিত নিয়ম অনুসরণ করে:

1. সহজ, সহজলভ্য ভাষা ব্যবহার করুন, প্রযুক্তিগত শব্দবাক্য এবং বাজওয়ার্ড এড়িয়ে চলুন
2. কথ্যভাষা এড়িয়ে চলুন
3. আক্ষরিক এবং কংক্রিট ভাষা ব্যবহার করুন
4. সংকোচন বাদ দিন
5. প্যাসিভ ভয়েস অল্প ব্যবহার করুন
6. একটি ইতিবাচক আকারে বাক্যাংশের বিবৃতিগুলিকে লক্ষ্য করুন
7. কোটেশনের বাইরে কোনো বিস্ময় চিহ্ন নেই
8. অতিরঞ্জিত করবেন না
9. পুনরাবৃত্তি এড়িয়ে চলুন
10. সংক্ষিপ্ত হোন

শ্রোতা

শব্দকোষটি প্রযুক্তিগত এবং অ-প্রযুক্তিগত দর্শকদের জন্য লেখা। অনুগ্রহ করে নিশ্চিত করুন যে সংজ্ঞাগুলি সহজ ভাষায় ব্যাখ্যা করা হয়েছে এবং প্রযুক্তিগত জ্ঞান গ্রহণ করবেন না। আরো যে সংজ্ঞা অধীনে নিচে রয়েছে ।

সংজ্ঞা টেমপ্লেট

প্রতিটি শব্দকোষ একটি মার্কডাউন ফাইলে সংরক্ষণ করা হয় এবং এই টেমপ্লেটটি অনুসরণ করে:

---
title: 
status: 
category: 
---


## এটা কি

প্রযুক্তি বা ধারণার একটি দ্রুত সারাংশ।

## এটা যেসব সমস্যাতে ফোকাস করে

এটি যে সমস্যার সমাধান করছে সে সম্পর্কে কয়েকটি লাইন।

## এটা কিভাবে সাহায্য করে

জিনিসটি কীভাবে সমস্যার সমাধান করে তার কয়েকটি লাইন।

Title

Title লেবেল সর্বদা একটি সংজ্ঞা লেআউটের শীর্ষে থাকবে এবং এর মান শিরোনামের ক্ষেত্রে হওয়া উচিত।

---
title: সংজ্ঞা টেমপ্লেট

Status

শিরোনাম লেবেলের পরে status লেবেল আসবে। স্থিতি লেবেল নির্দেশ করে যে সংজ্ঞাগুলি পুঙ্খানুপুঙ্খভাবে যাচাই করা হয়েছে বা আরও প্রচেষ্টার প্রয়োজন আছে কিনা।

বৈধ মান হল:

• সম্পন্ন
• প্রতিক্রিয়া প্রশংসিত
• শুরু না

আপনি সর্বদা একটি সম্পূর্ণ সংজ্ঞার বিরুদ্ধে একটি issue খুলতে পারেন। একটি সংজ্ঞা প্রবাহিত হওয়ার সময়, এটির স্থিতি Feedback Appreciated এ পরিবর্তিত হবে।

---
title: সংজ্ঞা টেমপ্লেট
status: Feedback Appreciated

Category

Category লেবেলটি স্ট্যাটাস লেবেলের পরে আসবে। এর মান নিম্নলিখিত মানগুলির মধ্যে একটি হওয়া উচিত:

• প্রযুক্তি
• সম্পত্তি
• ধারণা

---
title: সংজ্ঞা টেমপ্লেট
status: Feedback Appreciated
category: ধারণা
---

সংজ্ঞা

তিনটি উপশিরোনাম

প্রযুক্তি এবং ধারণা বিভাগের সংজ্ঞায় তিনটি উপশিরোনাম রয়েছে:

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

মনে রাখবেন বৈশিষ্ট্য-এর আলাদা বিভাগের প্রয়োজন নেই। একটি সংজ্ঞা যথেষ্ট হবে।

জিনিসগুলি সহজ রাখুন

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

উপযুক্ত হলে, বাস্তব-জগতের উদাহরণ ব্যবহার করুন যা পাঠকদের (বিশেষ করে অ-প্রযুক্তিগত) আরও ভালোভাবে বুঝতে সাহায্য করে কখন এবং কেন আপনি যে ধারণাটি ব্যাখ্যা করছেন তা প্রাসঙ্গিক।

আপনার সংজ্ঞায় ব্যবহৃত হলে, সর্বদা বিদ্যমান শব্দকোষের শর্তাবলীর সাথে লিঙ্ক করুন (শুধুমাত্র প্রথম উল্লেখ হাইপারলিঙ্ক করা উচিত)।

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

একটি Google বা Word ডক দিয়ে শুরু করুন

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

একটি মেয়াদে কাজ করার সময় অন্য কেউ PR জমা না দেয় তা নিশ্চিত করতে, একটি সমস্যা দাবি করা (বা একটি তৈরি করুন) এবং এটি আপনাকে বরাদ্দ করা হয়েছে তা নিশ্চিত করুন। কীভাবে অবদান রাখতে হয় ডক-এ আরও কিছু আছে যা দেখতে পারেন ।

শুরু করার আগে, অনুগ্রহ করে কিছু প্রকাশিত শব্দকোষের পদ পড়ুন যাতে বিশদ এবং অসুবিধার মাত্রা এবং উদাহরণগুলি বোঝা যায়।

পর্যালোচনা প্রক্রিয়া: কি আশা করা যায়

দয়া করে মনে রাখবেন যে আমরা বর্তমানে শুধুমাত্র তিনজন রক্ষণাবেক্ষণকারী তাদের অবসর সময়ে এটি করে। মাঝে মাঝে, আমরা দ্রুত শর্তাবলী পর্যালোচনা করতে সক্ষম হব; অন্যান্য অনুষ্ঠানে, এটি কিছুটা সময় নিতে পারে — আমরা আপনার ধৈর্যের প্রশংসা করি। আপনার যদি কোনো প্রশ্ন থাকে, তাহলে অনুগ্রহ করে #glossary Slack চ্যানেলে আমাদের সাথে যোগাযোগ করুন (কোথায় এবং কীভাবে এটি খুঁজে পাবেন, অনুগ্রহ করে আমাদের কীভাবে অবদান রাখবেন ডকটি দেখুন ।

আমাদের লক্ষ্য হল শব্দকোষ সর্বোত্তম সম্ভাব্য সম্পদ। একবার আপনি একটি PR জমা দিলে, আমরা এক বা একাধিক সংশোধনের জন্য জিজ্ঞাসা করতে পারি। হতাশ হবেন না — এটি অনেক PR -এর ক্ষেত্রে। সেই সব নিশ্চিত করবে যে আপনার অবদান একটি সত্যিকারের দরকারী সংজ্ঞা হয়ে উঠবে যা সারা বিশ্বের পাঠকদের দ্বারা পঠিত হবে।