erg/doc/zh_CN/dev_guide/doc_guideline.md
2022-10-15 16:54:42 +08:00

15 lines
No EOL
1.1 KiB
Markdown

# 格式
[![badge](https://img.shields.io/endpoint.svg?url=https%3A%2F%2Fgezf7g7pd5.execute-api.ap-northeast-1.amazonaws.com%2Fdefault%2Fsource_up_to_date%3Fowner%3Derg-lang%26repos%3Derg%26ref%3Dmain%26path%3Ddoc/EN/dev_guide/doc_guideline.md%26commit_hash%3Da9d45b743cc655543e0d7f586426499091cead3d)](https://gezf7g7pd5.execute-api.ap-northeast-1.amazonaws.com/default/source_up_to_date?owner=erg-lang&repos=erg&ref=main&path=doc/EN/dev_guide/doc_guideline.md&commit_hash=a9d45b743cc655543e0d7f586426499091cead3d)
任何不符合以下规则的文件都将得到更正
* 以某种语气写代码注释或内部文档
* 向外部(普通用户)展示的文档应该越来越多地编写
* 始终包含定义、含义或文档中首次出现的术语的链接
* 仅对理解正文所必需的补充句子使用括号作为附加条件,对于理解正文不是必需的句子使用脚注[<sup id="f1">1</ sup>](#1)
* 如果文档内容过时,按照[此方法](https://github.com/erg-lang/erg/issues/48#issuecomment-1218247362)更新
---
<span id="1" style="font-size:x-small"><sup>1</sup> 参见这里了解如何编写脚注。[](#f1)</span>