Add a scaffold script that replaces the bq prefix with the new project name.
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
27
doc/项目文档/基础应用/*基础应用文档撰写说明.md
Normal file
27
doc/项目文档/基础应用/*基础应用文档撰写说明.md
Normal file
@@ -0,0 +1,27 @@
|
||||
# 基础应用文档撰写说明
|
||||
|
||||
适用文件:`doc/基础应用/<中文名>(目录名).md`。一个 `src/app` 子目录一篇。
|
||||
|
||||
## 目录
|
||||
|
||||
- [1. 功能定义](#1-功能定义)
|
||||
- [2. 使用示例](#2-使用示例)
|
||||
- [3. 数据流与时序](#3-数据流与时序)
|
||||
|
||||
示例见 [基础应用(示例)](./基础应用(示例).md)。
|
||||
|
||||
## 1. 功能定义
|
||||
|
||||
一段话说明这个基础应用做什么。下列出对外入口:类或函数、文件路径、各自负责的事。
|
||||
|
||||
## 2. 使用示例
|
||||
|
||||
给出调用这个入口的代码,并注明代码所在文件。示例表现功能模块或路由怎样使用它。一个入口一段示例;入口很小且调用方式相同时可以合在一段里。
|
||||
|
||||
## 3. 数据流与时序
|
||||
|
||||
一条行为优先用时序图。时序图已经能说明调用顺序时,不要再画数据流图。数据流图只在时序图表达不了数据经过哪些对象时再补。图中只用本目录的类名、函数名、方法名。图下用中文复述这条路径。
|
||||
|
||||
本节标题按实际采用的图来写。只有时序图时,标题为「时序」。
|
||||
|
||||
不画功能模块的调用链,例如 `SecurityViewModel` 到 `SecurityApplication`。不把其他基础应用的内部步骤画进本篇。功能模块何时调用这些入口,由功能模块文档的时序图说明。使用示例里的代码片段可以来自调用方。
|
||||
Reference in New Issue
Block a user