知识卡片
自由与严格
两类文档工具各有所长:Hologram 格式非常自由,不关心写什么、写在哪种文件里,像一张白纸,适合写组件示例、入门文档和团队规则;SassDoc 专门记录 Sass 的变量、混入、继承和函数,对注释后的代码要求严格,还能自动列出依赖关系和被引用关系,适合大型 Sass 框架。现代样式文档常组合多种工具,各自展示系统的不同部分。
这张卡片看不懂?
这张卡片已通过人工审查,不再接受失败反馈。
已有反馈 · 0 条
还没有人提交反馈。
原书出处
参考来源
- 位置:《前端架构设计》第15章《样式文档》(源文件:_epub-src/OEBPS/text00000.html)
- 结论依据:原文说明 Hologram 是格式非常自由的文档系统,不关心内容和文件类型;SassDoc 专门记录 Sass 变量、混入、继承和函数,对注释块后的代码有严格要求,并能自动建立依赖映射。
- 原始内容:Hologram 是一个格式非常自由的文档系统,它并不关心它的内容,以及它写在什么类型的文件中。……Hologram 只是把文档分成不同的组,而 SassDoc 则会自动建立起变量和函数或者混入和扩展的映射关系。