Question

本节作者：余兴超
阅读级别：选读
阅读时间: 0.5 小时

本章节也是选读章节，仅对模块做了一个简单介绍。
puppet-openstack-specs 模块是用于管理 Blueprint design document，对 Openstack 了解的同学应该知道，在早年，社区使用 Launchpad 来管理 BluePrint(BP)，后来过渡到使用这种 Markdown 语法编写+Code review 的方式来管理功能开发文档，我觉得这是一个非常好的设计，在文档的格式定义，归档，搜索上有非常有益的尝试。

模块讲解

与 PuppetOpenstack 相关的 specs 放在 specs/目录下，并根据 release 版本不同，划分出了不同的目录。

例如以 Newton 的某个 BP 为例： Configuration File Deprecation Support

它使用如下目录对 BP 进行详细地描述:

• Problem description #问题描述
• Proposed change #提出的改进计划
  • Alternatives #其他替代方案
  • Data model impact #对数据模型的影响
  • Module API impact #对模块 API 的影响
  • End user impact #对终端用户的影响
  • Performance Impact #对性能的影响
  • Deployer impact #对部署人员的影响
  • Developer impact #对开发人员的影响
• Implementation # 实现相关
  • Assignee #指派人
  • Work Items #任务列表
• Dependencies #依赖
• Testing #测试
• Documentation Impact #对文档的影响
• References #参考链接

总结为四个字：非常专业。