erg/doc/zh_TW/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>