( ) 和 [ ] 可供选择。然而缺少修饰的方括号会在数组和 slice 的类型声明中造成歧义，在解析索引表达式时也会引起小程度的歧义。因此在设计之初他们决定使用小括号，因为小括号似乎更符合 Go 语言的风格，而且看起来问题最少。 为了使小括号正常工作，并且为了向后兼容，他们表示不得不在类型参数列表中引入type关键字。最后，他们在参数列表、复合字面量和嵌入类型中发现了额外的解析歧义，而这些歧义需要嵌套更多的小括号来解决。不过即便如此，他们还是决定继续使用小括号，因为当时还有更重要的设计问题需要解决。 现在他们决定重新考虑这个最初的决定。如果仅使用方括号声明类型参数，那么声明数组的方式如下所示： type A [N]E 不过这就无法与泛型的声明进行区分： type A[N] E 但如果能接受额外的...阅读全文
Debian.cn 正式更名为 Debian中国。相比我们之前使用的名字”Debian社区“，这个名字更中性一些，也避免了歧义。 Debian.cn 的内容风格还会和以前保持一致，不会有明显变化，我们会继续重点关注 Debian系统 在生产环境的基础设施上的广泛应用，包括容器化、业务环境、大数据、媒体智能等。 这次一同调整的还有论坛功能。由于论坛中的的内容很少，我们上线了独立的讨论平台 bbs.debian.cn，和主站的账号系统保持独立，并简化了注册。论坛的后台系统使用Discuz! Q 这个刚推出不久的开源的系统，欢迎注册。...阅读全文
预设了很多背景知识。 一般使用文档都是有开发者写的，他们都非常了解这个工具的相关的知识，所以习惯性的会认为，啊 这个知识点很简单 用户也肯定会吧，实际上用户不一定会。这本质上就是一种认知偏差，这种现象在跨团队协作 尤其是多端协作的时候也非常明显。 这类型的文档写作中，要求写作者尽可能站在用户的视角上思考，极力避免出现和用户的认知偏差，力争每个步骤做到明确无歧义，每两个步骤之间做到紧密衔接。 ## 概念性文档 ## 当参考文档无法解释清楚某些东西的时候，就需要概念性文档了，比如某个API的具体实现原理。其主要是为了扩充参考文档，而不是替代参考文档。有时候这和参考文档会有些内容重复，但主要还是为了更深层次的说明某些问题、解释清楚某个概念。 概念性文档也是所有文档中写作最难的，也是被阅读最少的，所...阅读全文
了。必须要改变什么来减少交互和预期的数量。面对激增的服务模型和大规模部署的痛点，我们通过Prodspec管理的intent以及Annealing针对该intent的持续执行，来实现生产环境的声明化管理。 在面向工作流的生产管理模型里，生产环境状态的大部分仅仅存在于生产环境里。比如，前端运行的是版本X，因为几天之前你才升级到这个特定版本。 相对应的，声明式生产意味着编写生产状态的intent——生产环境应该运行版本X——使用某个配置文件或者数据库。生产状态现在是从intent派生出来的。配合持续推进，就可以确保生产状态和用户预期相匹配。 在我们的实践里，intent通常是直观的，很少有歧义。但是，维护intent是困难的，要求大量的逻辑。Prodspec（下一节会更深入地讨论）是这个建模问题的...阅读全文
