टैग वाले लेख: CI/CD
Documentation को build artifact की तरह लें: publish होने से पहले structure, links, examples और rules validate करें। CI usefulness तय नहीं कर सकता, लेकिन human review से पहले predictable defects रोक सकता है। Documentation build को quality gate मानें।
अगर model scale पर documentation create या update करता है तो validation भी scale पर चाहिए। Inputs constrain करें, provenance रखें, structure validate करें और generation को privileged publishing से अलग रखें।
Style linting तब उपयोगी है जब वह terminology drift, risky wording और repeatable editorial defects पकड़े। Rules कम, स्पष्ट और इतने शांत रखें कि failed check पर writers भरोसा करें। Linter कुछ सेकंड में हजारों sentences check कर सकता है, इसलिए हर editorial preference encode करने का मन होता है। ऐसा न करें। पहले गलत product names, inconsistent terminology, risky wording, ambiguous warnings और repeated formatting errors प…