知识卡片
模板元数据按实际需要取舍
标签对大集合检索有价值,在几份小文档中可能只是负担;固定作者字段还可能让维护者误以为只有原作者能修改。版本历史可反映多人贡献,正式提案则可能仍需明确责任人。要区分署名、决策责任和更新权限,避免模板在无意中阻碍协作。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
在整书笔记中的位置
原书出处 · 1 处
- 第9章 文档化你的项目 9.4 构建自己的文档集 · 查看原书依据
人们倾向于将文档作者也视为文档所有者
参考来源
- 位置:《Python编程精进(第1辑)(套装共3册)(异步图书)》Python高级编程(第2版) · 第9章 文档化你的项目,spine018单元018;来源项目book-sources,extracted/Python编程精进(第1辑)(套装共3册)(异步图书)/_epub-src/OEBPS/text00017.html。
- 结论依据:原文提醒作者字段会暗示所有权,支持署名与修改责任分开,标签收益也需相对文档集合规模判断。未在本机运行示例或改变环境。
- 原始内容:,无论何时有需要,这些文件都会不断更新。人们倾向于将文档作者也视为文档所有者。如果每个文档的作者总是指定的,这可能会阻止人们更新文档。通常,与明确提供的元数据注释相比,版本控制软件可以提供关于真实文档作者的更清楚和更透明的信息。真正推荐明确作者的