Skip to content

Docs: 考虑调整现行文档中部分章节的顺序 #3057

Open
@NCBM

Description

描述问题或主题

很多初学者阅读文档时会按照文档的编排顺序进行学习与操作,然而目前文档的编排顺序并不足够利于初学者上手。例如:

  • “手动创建项目”章节为普通用户不必详细了解的内容,然而其被安排在“指南”的第一节;

    普通用户应尽可能使用 nb-cli 脚手架完成操作。

  • “获取商店内容”章节为普通用户和开发者均应了解的内容,其被安排在“指南”的中部;

    普通用户从商店中快速选用想要的功能插件并利用 nb-cli 进行安装,开发者从商店中选用需要的工具库。

  • “编辑器支持”章节情况与“手动创建项目”章节类似。

需做出的修改

个人的想法:

  • “手动创建项目”章节应置于“深入”或“进阶”部分;
  • “获取商店内容”章节应置于“开始”部分;
  • “编辑器支持”章节应置于“指南”部分。

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions