加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
文件
克隆/下载
AUTHORS_README.adoc 1.16 KB
一键复制 编辑 原始数据 按行查看 历史
evanshultz 提交于 2016-06-18 11:22 . Two minor typos (#381)

README for doc authors

To start writing a new document, follow these steps:

1) read the README.adoc for the preliminary requirements.

2) create a directory with the same name of the doc title lowercase with underscore for space.

3) copy a master document from other docs to simplify coherency and change whatever needs to be changed.

4) follow the convention to call the name of the document with the same name of the doc project dir

5) if the document is rather large and you want to break it into separate chapters, follow the convention of calling the chapter files as:

docname_chapter_name-or-number.adoc

The first _ character will separate the docname from the chapter names and will guarantee automatic inclusion of the chapters into the final output formats.

6) when you reach a worthwhile point on your document, create a patch with:

git add docname
git commit -m "Added manual docname, first draft"
git format-patch HEAD^

and send it to the devels or fork with gitbub web interface and ask for pull merging.

Please, before committing any file, check for functionality, to avoid breaking automatic compilation of docs.

Happy writing!

马建仓 AI 助手
尝试更多
代码解读
代码找茬
代码优化