Skip to content
Apothem
संदर्भ

गद्य अभिसमय

RFC 2119 मॉडल पदानुक्रम को लागू करता है, विपणन विशेषणों और टालमटोल भराव को प्रतिबंधित करता है, निरपेक्ष ISO-8601 तिथियों का उपयोग करता है, और निर्देशात्मक गद्य की जलरोधकता को मान्य करता है।

प्रत्येक रचित Markdown सतह पर गद्य अनुशासन के लिए विहित संदर्भ। CLAUDE.md अभिसमय में दिया सारांश इनलाइन घोषणा है; यह पृष्ठ वह स्वतंत्र संदर्भ है जिसे निम्नधारा योगदानकर्ता उद्धृत करते हैं।


1. मॉडल पदानुक्रम (RFC 2119)

निर्देशात्मक गद्य RFC 2119 मॉडल पदानुक्रम का उपयोग करता है: MUST, MUST NOT, SHOULD, SHOULD NOT, MAY। प्रत्येक उस बाध्यकारी-शक्ति को धारण करता है जिसे RFC परिभाषित करता है। लोअरकेस मॉडल (must, should) कोई मानक भार नहीं रखते और केवल उस वर्णनात्मक गद्य में उपयोग किए जाते हैं जहाँ कोई दायित्व घोषित नहीं किया जा रहा।

2. प्रतिबंधित शब्दावली

2.1 विपणन विशेषण

powerful, seamless, robust, cutting-edge, next-generation, world-class, enterprise-grade और समतुल्य शब्द उपयोगकर्ता-सम्मुख कलाकृतियों में प्रतिबंधित हैं, जब तक कि मापे गए साक्ष्य से उन्हें ठोस रूप से प्रमाणित न किया जाए। प्रमाणन किसी बेंचमार्क, तुलना, माप या बाह्य सत्यापन स्रोत को उद्धृत करता है।

2.2 टालमटोल भराव

basically, kind of, sort of, in some sense, to some extent और समतुल्य शब्द निर्देशात्मक पाठ में प्रतिबंधित हैं। निर्देशात्मक गद्य बाध्यकारी है; टालमटोल वाली शब्दावली उस बाध्यकारी बल को त्याग देती है जिसका गद्य दावा करता है।

2.3 UDA जलरोधकता

scripts/dev/validate_ecosystem.py पर सार्वभौमिक-निर्देश-जलरोधकता (UDA) जाँच, बाध्यकारी विधान धारण करने वाली पंक्तियों पर एक बंद टालमटोल शब्दकोश (maybe, might, could, should probably, usually, generally speaking, in most cases, mostly, typically, often, or similar, etc., and so on) को लागू करती है। नियम के स्वयं के विषय के रूप में उद्धृत टालमटोल टोकन (उदाहरण के लिए, किसी प्रतिबंध-सूची पृष्ठ पर प्रतिबंधित शब्दों की एक सूची) मान्यकर्ता के परिभाषात्मक-चिह्नक तंत्र द्वारा छूट प्राप्त हैं।

3. तिथि संदर्भ

तिथियाँ प्रत्येक संदर्भ पर निरपेक्ष ISO-8601 (YYYY-MM-DD) होती हैं। सापेक्ष तिथियाँ (yesterday, last week, recently) उन कलाकृतियों में प्रतिबंधित हैं जो अपने रचना-सत्र से परे बनी रहती हैं।

4. मान्यकर्ता

scripts/dev/validate_ecosystem.py की UDA जलरोधकता जाँच §2.3 के लिए यांत्रिक प्रवर्तन सतह है। प्रति-लेखन markdown परिवार के conformity-grep मान्यकर्ता PreToolUse Write/Edit हुक सीमाओं पर व्यापक गद्य-गुणवत्ता मानदंड को लागू करते हैं।

On this page