diff --git a/README.md b/README.md index 6d27213fa0654907b4afedd4b825aed7db0a27b7..a993dc3272a91bfbbdef16c82aaf24c1f4113a72 100644 --- a/README.md +++ b/README.md @@ -1,37 +1,54 @@ -# docs - -#### 介绍 -文档系统仓库 - -#### 软件架构 -软件架构说明 - - -#### 安装教程 - -1. xxxx -2. xxxx -3. xxxx - -#### 使用说明 - -1. xxxx -2. xxxx -3. xxxx - -#### 参与贡献 - -1. Fork 本仓库 -2. 新建 Feat_xxx 分支 -3. 提交代码 -4. 新建 Pull Request - - -#### 特技 - -1. 使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md -2. Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com) -3. 你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目 -4. [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目 -5. Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help) -6. Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/) +# openAnolis 文档 + +## 介绍 +龙蜥社区文档，涵盖开发者类、产品类、技术类、运营类、基础设施类，等五大类文档，帮助社区用户快速了解 openAnolis。 +仓库文档会同步更新到龙蜥社区，访问地址：https://docs.openanolis.cn/ + +参与文档贡献请参考如下说明： + +## 1 如何新增、修改文档 +### 1.1 新增、修改目录或文件 +第一步：fork仓库gitee.com/anolis/docs或使用gitee WebIDE 进入docs仓库 +第二步：在五大目录下新建目录或文件。 + +五大目录分别对应： +|目录名称|展示名称| +|--|--| +|DEVELOPER_DOCS|开发者类| +|PRODUCT_DOCS|产品类| +|TECHNOLOGY_DOCS|技术类| +|OPERATIONS_DOCS|运营类| +|INFRA_DOCS|基础设施类| + +### 1.2 编排目录层级 +修改内容所属五大类目录下menu.yaml文件，来编排目录，目录层级会体现在龙蜥社区文档系统中。 + +修改说明： +* 默认一个缩进为一级目录，两个缩进为二级目录，三个缩进为三级目录。 +* 文件地址使用：名称+“:”+路径的形式，如：xx文件:../xx/xx.md + +注意事项： +* 前三行为默认内容无必要请不要修改。 +* 只支持.md结尾文件，作为文档路径 +* “:”冒号为英文格式 + +### 1.3 设置目录审查人 +修改内容所属五大类目录下maintainers.yaml文件，设置目录对应maintainer，后续涉及到该目录下内容的修改PR，系统会自动将maintainer设置为该PR的审查人。 + +修改说明： +* maintainers为自定义分组，在每个具体的分组下可指定maintainer，包括龙蜥社区帐户id以及gitee账户id +* paths用来指定每个文档路径对应的用户组权限，每个用户组可单独作用于path路径 + +具体使用规则介绍： +* 整体控制：default_group分组可以控制整个文档类别下所有文档的权限。 +* 细粒度控制：每类文档可自行定义各路径的 maintainer 分组。 +* 配置文件权限：使用default_group分组控制 maintainers.yml及menu.yml的权限。 +* 优先级及用户选择： + a. 当同一个文档被多个路径所代表的权限组同时覆盖时，优先使用最小范围的 maintainer 分组。 + b. 当同一个 PR 中既有配置文件和内容文件更新时，会同时使用对应的权限组控制。 + +### 1.4 提交PR +将以上修改提交到Gitee仓库上，并在Gitee上创建一个Pull Request。同步程序会自动检查内容是否符合规范，如不符合规范请按提示修改。修改后可在Pull Request评论区，回复“/retest”指令重新检查，直到同步程序回复可以同步为止。如回复指令后评论区未看到提示，请刷新页面后再查看。 +注意：同步时只支持“/retest”指令，暂不支持其它指令 + +## FAQ \ No newline at end of file