feat: unify source and skills for Dever 0.1.2 installation
This commit is contained in:
1 parent
a2e0436ed4
commit
19f122b4b4
47 files changed
+1951
-63
No files matched your search
@@ -0,0 +1,15 @@
|
||||
# Markdown 源码
|
||||
|
||||
使用 `dever new <new-directory> --markdown` 获得经过验证的模板;不要只把任意 Markdown 中的代码围栏改名当作完整程序。
|
||||
|
||||
文件后缀 `.dever.md`;编译器只编译顶层 `dever` 或 `typescript dever` 围栏,且校验说明与代码合同。普通 `.md` 不是源码,两种源码格式的类型、目录、访问、权限约束一致。
|
||||
|
||||
- 每个文件一个一级标题,随后写用途、包、公开类型、公开方法、使用;空项写“无”。包说明来自路径,不是源码 package 声明。
|
||||
- 每个逻辑声明有自己的二级标题、用途和唯一代码块,一级标题下不直接放源码。
|
||||
- 类型写 `- 类型:` 与字段/分支说明;函数写 `- 函数:`、输入、输出,名称、类型、顺序与代码一致。每个字段说明包含非空中文用途。
|
||||
- 同名同参数数量的所有分句放同一章节、同一围栏;不同签名或类型分开。
|
||||
- API 写 `- 声明:cmd greet`、`post publish`、`rest model` 等,与代码一致,不虚构公开方法。
|
||||
- App 自动公开其类型/函数;Domain、Adapter、API 和测试没有公开方法。调用清单隐藏 app role 和 app topic。
|
||||
- 测试同样需要完整说明,唯一入口仍是文件同名零输入零输出函数。
|
||||
|
||||
维护源码与说明后一起跑 fmt --check、check。完整声明说明协议见官方核心仓库同版本 MARKDOWN-SYNTAX.md。
|
||||
Reference in new issue
Block a user