nemo-rl-docs

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Documentation Conventions

文档规范

Keep docs/index.md Up to Date

保持 docs/index.md 内容更新

When a new markdown doc is added under
docs/**/*.md
or a markdown file is renamed, ensure that @docs/index.md is updated and the document appears in the most appropriate section.
当在
docs/**/*.md
下添加新的Markdown文档或重命名Markdown文件时,请确保更新 @docs/index.md,并将文档放置在最合适的章节中。

Docstring Format

文档字符串格式

Use Google style docstrings for classes and functions. These are parseable by Sphinx.
For interfaces that may be used outside a file, prefer docstrings over comments. Comments should be reserved for code within a function or interfaces local to a file.
为类和函数使用Google风格的文档字符串,这类文档字符串可被Sphinx解析。
对于可能在文件外部使用的接口,优先使用文档字符串而非注释。注释应仅用于函数内部代码或文件本地的接口。

Document New Features

为新功能编写文档

When a new feature is added, update or create documentation in the
docs/
directory that most closely matches the feature. Look at existing docs to find the best fit — if none exists, create a new doc and add it to @docs/index.md.
Documentation changes are not required for bug fixes or CI-related changes.
当添加新功能时,请在
docs/
目录中更新或创建与该功能最匹配的文档。参考现有文档找到最合适的位置——如果没有合适的位置,请创建新文档并将其添加到@docs/index.md中。
bug修复或CI相关变更无需修改文档。