You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: content/bn/style-guide/_index.md
+60-64Lines changed: 60 additions & 64 deletions
Original file line number
Diff line number
Diff line change
@@ -7,125 +7,121 @@ menu:
7
7
pre: <i class='fas fa-ruler-horizontal'></i>
8
8
---
9
9
10
-
This style guide will help you understand the Glossary audience, definition structure, required level of detail, and how to maintain a consistent style.
10
+
এই শৈলী নির্দেশিকা আপনাকে শব্দকোষের শ্রোতা, সংজ্ঞা কাঠামো, প্রয়োজনীয় বিশদ স্তর এবং কীভাবে একটি সামঞ্জস্যপূর্ণ শৈলী বজায় রাখতে হয় তা বুঝতে সাহায্য করবে।
11
11
12
-
The Cloud Native Glossary follows the [default style guide](https://github.com/cncf/foundation/blob/master/style-guide.md)of the CNCF repository. Additionally, it follows the following rules:
12
+
ক্লাউড নেটিভ শব্দকোষ CNCF সংগ্রহস্থলের [ডিফল্ট স্টাইল গাইড](https://github.com/cncf/foundation/blob/master/style-guide.md)অনুসরণ করে। উপরন্তু, এটি নিম্নলিখিত নিয়ম অনুসরণ করে:
13
13
14
-
1.Use simple, accessible language, avoiding technical jargon and buzzwords
5.[প্যাসিভ ভয়েস অল্প ব্যবহার করুন](https://www.ef.com/ca/english-resources/english-grammar/passive-voice/)
19
+
6.[একটি ইতিবাচক আকারে বাক্যাংশের বিবৃতিগুলিকে লক্ষ্য করুন](https://examples.yourdictionary.com/positive-sentence-examples.html)
20
+
7.[কোটেশনের বাইরে কোনো বিস্ময় চিহ্ন নেই](https://www.grammarly.com/blog/exclamation-mark/)
21
+
8.অতিরঞ্জিত করবেন না
22
+
9.পুনরাবৃত্তি এড়িয়ে চলুন
23
+
10.সংক্ষিপ্ত হোন
24
24
25
-
## Audience
25
+
## শ্রোতা
26
26
27
-
The Glossary is written for a technical AND non-technical audience. Please ensure definitions are explained in simple terms and don’t assume technical knowledge. More do that below under Definition.
27
+
শব্দকোষটি প্রযুক্তিগত এবং অ-প্রযুক্তিগত দর্শকদের জন্য লেখা। অনুগ্রহ করে নিশ্চিত করুন যে সংজ্ঞাগুলি সহজ ভাষায় ব্যাখ্যা করা হয়েছে এবং প্রযুক্তিগত জ্ঞান গ্রহণ করবেন না। আরো যে সংজ্ঞা অধীনে নিচে রয়েছে ।
28
28
29
-
## Definition Template
29
+
## সংজ্ঞা টেমপ্লেট
30
30
31
31
Each glossary term is stored in a markdown file and follows this template:
32
32
33
-
```md
34
33
---
35
34
title:
36
35
status:
37
36
category:
38
37
---
39
38
40
-
## What it is
39
+
## এটা কি
41
40
42
-
A quick summary of the technology or concept.
41
+
প্রযুক্তি বা ধারণার একটি দ্রুত সারাংশ।
43
42
44
-
## Problem it addresses
43
+
## এটা যেসব সমস্যাতে ফোকাস করে
45
44
46
-
A few lines about the problem it's addressing.
45
+
এটি যে সমস্যার সমাধান করছে সে সম্পর্কে কয়েকটি লাইন।
47
46
48
-
## How it helps
47
+
## এটা কিভাবে সাহায্য করে
49
48
50
-
A few lines on how the thing solves the problem.
51
-
```
49
+
জিনিসটি কীভাবে সমস্যার সমাধান করে তার কয়েকটি লাইন।
52
50
53
51
### Title
54
52
55
-
The **title** label will always be at the top of a definition layout, and its value should be in title case.
53
+
*Title* লেবেল সর্বদা একটি সংজ্ঞা লেআউটের শীর্ষে থাকবে এবং এর মান শিরোনামের ক্ষেত্রে হওয়া উচিত।
56
54
57
-
```md
58
55
---
59
-
title: Definition Template
60
-
```
56
+
title: সংজ্ঞা টেমপ্লেট
61
57
62
58
### Status
63
59
64
-
The **status** label will come after the title label. The status label indicates whether definitions are thoroughly vetted or require more effort.
60
+
শিরোনাম লেবেলের পরে *status* লেবেল আসবে। স্থিতি লেবেল নির্দেশ করে যে সংজ্ঞাগুলি পুঙ্খানুপুঙ্খভাবে যাচাই করা হয়েছে বা আরও প্রচেষ্টার প্রয়োজন আছে কিনা।
65
61
66
-
Valid values are:
62
+
বৈধ মান হল:
67
63
68
-
-Completed
69
-
-Feedback Appreciated
70
-
-Not Started
64
+
-সম্পন্ন
65
+
-প্রতিক্রিয়া প্রশংসিত
66
+
-শুরু না
71
67
72
-
You can always open an issue against a completed definition. While a definition is in flux, its status will be changed to *Feedback Appreciated*.
68
+
আপনি সর্বদা একটি সম্পূর্ণ সংজ্ঞার বিরুদ্ধে একটি issue খুলতে পারেন। একটি সংজ্ঞা প্রবাহিত হওয়ার সময়, এটির স্থিতি Feedback Appreciated এ পরিবর্তিত হবে।
73
69
74
-
```md
75
70
---
76
-
title: Definition Template
71
+
title: সংজ্ঞা টেমপ্লেট
77
72
status: Feedback Appreciated
78
-
```
79
73
80
74
### Category
81
75
82
-
The **category** label will come after the status label. Its value should be one of the following values:
76
+
*Category* লেবেলটি স্ট্যাটাস লেবেলের পরে আসবে। এর মান নিম্নলিখিত মানগুলির মধ্যে একটি হওয়া উচিত:
83
77
84
-
- Technology
85
-
- Property
86
-
- Concept
87
-
88
-
```md
78
+
- প্রযুক্তি
79
+
- সম্পত্তি
80
+
- ধারণা
81
+
-
89
82
---
90
-
title: Definition Template
83
+
title: সংজ্ঞা টেমপ্লেট
91
84
status: Feedback Appreciated
92
-
category: Concept
85
+
category: ধারণা
93
86
---
94
-
```
95
87
96
-
### Definition
88
+
### সংজ্ঞা
89
+
90
+
#### তিনটি উপশিরোনাম
91
+
92
+
*প্রযুক্তি* এবং *ধারণা* বিভাগের সংজ্ঞায় তিনটি উপশিরোনাম রয়েছে:
97
93
98
-
#### Three subheadings
94
+
-*এটা কি*: আমরা যে বিষয়ে কথা বলছি তার একটি সংক্ষিপ্ত এবং স্পষ্ট ধারণা প্রদান করুন।
95
+
-
96
+
-*এটা যেসব সমস্যাতে ফোকাস করে*: সমস্যাটির উপর ফোকাস করুন, সমাধানের দিকে নয় (যা পরবর্তী বিভাগে আসে)। আসলে, সংজ্ঞায়িত শব্দটি উল্লেখ করা এড়িয়ে চলুন। সমস্যাটি আমাদের সেই জিনিসটির প্রয়োজন কিসের উপর তাতে আলোকপাত করে ।
97
+
-
98
+
-*এটা কিভাবে সাহায্য করে*: এখন, মেয়াদে ফিরে আসুন। এটি কিভাবে উপরে বর্ণিত সমস্যার সমাধান করে?
99
99
100
-
The definitions for **technology** and **concept** categories contain three subheadings:
100
+
মনে রাখবেন **বৈশিষ্ট্য**-এর আলাদা বিভাগের প্রয়োজন নেই। একটি সংজ্ঞা যথেষ্ট হবে।
101
101
102
-
-**What it is**: provide a short and clear overview of what we are talking about.
103
-
-**Problem it addresses**: focus on the problem, not the solution (that comes in the next section). In fact, avoid mentioning the term that is defined. The problem focuses on *what* led us to need that thing.
104
-
-**How it helps**: now, come back to the term. How does it address the problem described above?
102
+
#### সহজ রাখুন
105
103
106
-
Note that **properties** don't require separate sections. A definition will suffice.
104
+
শব্দকোষের লক্ষ্য *জটিল ধারণাগুলিকে সহজ শব্দে ব্যাখ্যা করা* — এটি একটি আশ্চর্যজনকভাবে কঠিন কাজ যা সম্ভবত একাধিক সংশোধন করতে পারে। আপনার সংজ্ঞা খসড়া করার সময় সর্বদা দর্শকদের কথা মাথায় রাখুন। শিল্পের শর্তাবলী এবং বাজওয়ার্ডগুলি ব্যবহার করা এড়িয়ে চলুন - আপনি সম্ভবত তাদের কাছে ফিরে যেতে পারবেন এবং স্বয়ংক্রিয়ভাবে সংশোধন করতে হবে।
107
105
108
-
#### Keeping it simple
106
+
উপযুক্ত হলে, *বাস্তব-জগতের উদাহরণ* ব্যবহার করুন যা পাঠকদের (বিশেষ করে অ-প্রযুক্তিগত) আরও ভালোভাবে বুঝতে সাহায্য করে কখন এবং কেন আপনি যে ধারণাটি ব্যাখ্যা করছেন তা প্রাসঙ্গিক।
109
107
110
-
The Glossary aims at **explaining complex concepts in simple words** — that is a surprisingly difficult task that will likely take multiple revisions. Always keep the audience in mind when drafting your definition. Avoid using industry terms and buzzwords — you'll probably catch yourself going back to them and may need to autocorrect.
108
+
আপনার সংজ্ঞায় ব্যবহৃত হলে, সর্বদা *বিদ্যমান শব্দকোষের শর্তাবলীর সাথে লিঙ্ক করুন* (শুধুমাত্র প্রথম উল্লেখ হাইপারলিঙ্ক করা উচিত)।
111
109
112
-
When appropriate, use **real-world examples** that help readers (especially non-technical ones) better understand *when* and *why* the concept you’re explaining is relevant.
110
+
*উদাহরণ*: [পরিষেবা মেশ সংজ্ঞা](https://glossary.cncf.io/service_mesh/) এর “এটি কী” বিভাগটি একবার দেখুন। এটি মাইক্রোসার্ভিস, পরিষেবা, নির্ভরযোগ্যতা এবং পর্যবেক্ষণযোগ্যতার সংজ্ঞাগুলির সাথে লিঙ্ক করে। উপরন্তু, এটি একটি মাইক্রোসার্ভিসেস পরিবেশে নেটওয়ার্ক চ্যালেঞ্জের তুলনা করে একটি বাস্তব-বিশ্বের উদাহরণ ব্যবহার করে (এমন কিছু যা অ-প্রযুক্তিগত লোকেরা সম্পর্কিত হতে পারে না) ওয়াইফাই সমস্যার (যা কেউ ল্যাপটপ ব্যবহার করে বুঝতে পারে)সাথে । যেখানে সম্ভব, সেই সংযোগটি তৈরি করার চেষ্টা করুন।
113
111
114
-
When used in your definition, always **link to existing glossary terms** (only the first mention should be hyperlinked).
115
112
116
-
**Example**: take a look at the “What it is” section of the [service mesh definition](https://glossary.cncf.io/service_mesh/). It links back to the microservices, service, reliability, and observability definitions. Additionally, it uses a real-world example comparing network challenges in a microservices environment (something non-technical people can't relate to) to wifi problems (something anyone using a laptop can understand). Where possible, try to make that connection.
117
113
118
-
#### Start with a Google or Word doc
114
+
#### একটি Google বা Word ডক দিয়ে শুরু করুন
119
115
120
-
We recommend starting with a Google or Word doc, letting it sit for a few days, and revisiting again. This will allow you to catch phrases or expressions that could be worded in a simpler and more accessible way. Also, make sure to run a spellcheck before submitting a PR.
116
+
আমরা একটি Google বা Word ডক দিয়ে শুরু করার পরামর্শ দিই, এটিকে কয়েক দিনের জন্য বসতে দিন এবং আবার দেখার জন্য। এটি আপনাকে বাক্যাংশ বা অভিব্যক্তিগুলি ধরতে দেয় যা একটি সহজ এবং আরও অ্যাক্সেসযোগ্য উপায়ে শব্দ করা যেতে পারে। এছাড়াও, PR জমা দেওয়ার আগে একটি বানান পরীক্ষা চালানো নিশ্চিত করুন।
121
117
122
-
To ensure no one else submits a PR while working on a term, make sure to claim an issue (or create one) and that it is assigned to you. More to that in the [How To Contribute](https://glossary.cncf.io/contribute/)doc.
118
+
একটি মেয়াদে কাজ করার সময় অন্য কেউ PR জমা না দেয় তা নিশ্চিত করতে, একটি সমস্যা দাবি করা (বা একটি তৈরি করুন) এবং এটি আপনাকে বরাদ্দ করা হয়েছে তা নিশ্চিত করুন। [কীভাবে অবদান রাখতে হয়](https://glossary.cncf.io/contribute/)ডক-এ আরও কিছু আছে যা দেখতে পারেন ।
123
119
124
-
Before getting started, please read some of the published Glossary terms to get a feeling for the level of detail and difficulty and when examples are appropriate.
120
+
শুরু করার আগে, অনুগ্রহ করে কিছু প্রকাশিত শব্দকোষের পদ পড়ুন যাতে বিশদ এবং অসুবিধার মাত্রা এবং উদাহরণগুলি বোঝা যায়।
125
121
126
122
127
-
## The review process: what to expect
123
+
## পর্যালোচনা প্রক্রিয়া: কি আশা করা যায়
128
124
129
-
Please note that we are currently only three maintainers doing this in their spare time. Occasionally, we'll be able to review terms quickly; on other occasions, it may take some time — we appreciate your patience. If you have any questions, please get in touch with us in the #glossary Slack channel (for where and how to find it, please refer to our [How To Contribute](https://glossary.cncf.io/contribute/)doc).
125
+
দয়া করে মনে রাখবেন যে আমরা বর্তমানে শুধুমাত্র তিনজন রক্ষণাবেক্ষণকারী তাদের অবসর সময়ে এটি করে। মাঝে মাঝে, আমরা দ্রুত শর্তাবলী পর্যালোচনা করতে সক্ষম হব; অন্যান্য অনুষ্ঠানে, এটি কিছুটা সময় নিতে পারে — আমরা আপনার ধৈর্যের প্রশংসা করি। আপনার যদি কোনো প্রশ্ন থাকে, তাহলে অনুগ্রহ করে #glossary Slack চ্যানেলে আমাদের সাথে যোগাযোগ করুন (কোথায় এবং কীভাবে এটি খুঁজে পাবেন, অনুগ্রহ করে আমাদের [কীভাবে অবদান রাখবেন](https://glossary.cncf.io/contribute/) ডকটি দেখুন ।
130
126
131
-
Our goal is for the Glossary to be the best possible resource. Once you submit a PR, we may ask for one or more revisions. Don't be frustrated — that is the case for many PRs. Those backs and forth and our collaboration will ensure that your contribution becomes a truly useful definition read and referred to by readers all around the globe.
127
+
আমাদের লক্ষ্য হল শব্দকোষ সর্বোত্তম সম্ভাব্য সম্পদ। একবার আপনি একটি PR জমা দিলে, আমরা এক বা একাধিক সংশোধনের জন্য জিজ্ঞাসা করতে পারি। হতাশ হবেন না — এটি অনেক PR -এর ক্ষেত্রে। সেই সব নিশ্চিত করবে যে আপনার অবদান একটি সত্যিকারের দরকারী সংজ্ঞা হয়ে উঠবে যা সারা বিশ্বের পাঠকদের দ্বারা পঠিত হবে।
0 commit comments