Glossary एक decision system है
Useful entry में preferred term, definition, deprecated variants, context और owner होना चाहिए।
High-friction concepts से शुरू करें
Support questions, inconsistent UI labels, translation issues या review disputes वाले terms पहले लें।
Concept और label अलग रखें
एक concept के कई historical names हो सकते हैं। Concept एक बार model करें, aliases record करें।
Terminology को workflow में रखें
Writing, translation और linting के लिए एक ही source उपयोग करें जहाँ संभव हो।
Owners और review dates रखें
Product बदलता है, definitions भी बदलती हैं। Terminology continuous maintenance है।
व्यावहारिक उदाहरण
“Terms and definitions: terminology system बनाना” को किसी वास्तविक page पर लागू करें। ऐसा content चुनें जिसमें headings, table, note, example, दोहराया गया term और कम-से-कम एक reader action हो। पहले author की तरह और फिर उस reader की तरह review करें जो internal vocabulary नहीं जानता।
Observable defects लिखें:
- कौन-सी structure ऐसा meaning देती है जो plain text में नहीं है;
- कौन-सा term spelling या meaning बदलता है;
- कौन-सी instruction unstated context पर निर्भर है;
- कौन-सा rule review में consistently check करना कठिन है।
Standard तब उपयोगी है जब दो editors उसी content पर लगभग समान निर्णय ले सकें। यदि rule सही लगता है पर representative page पर दिखाया नहीं जा सकता, तो उसे स्पष्ट करें, example जोड़ें या scope छोटा करें।
त्वरित संपादकीय जाँच
- Glossary एक decision system है. Useful entry में preferred term, definition, deprecated variants, context और owner होना चाहिए।
- High-friction concepts से शुरू करें. Support questions, inconsistent UI labels, translation issues या review disputes वाले terms पहले लें।
- Concept और label अलग रखें. एक concept के कई historical names हो सकते हैं। Concept एक बार model करें, aliases record करें।
- Terminology को workflow में रखें. Writing, translation और linting के लिए एक ही source उपयोग करें जहाँ संभव हो।
