Stack Overflow新推出了一个名为Documentation的网站，让开发人员可以创建有关各种软件开发主题的文档，供其他开发人员参考。
与Stack Overflow Q&A网站旨在回答特定的问题不同，新网站的目标是提供关于许多编程技术的参考和指导文档。它类似一个由开发人员编写的在线手册。
文档的组织以Q&A网站上现有的将近5万个标签为基础。由于尚在起步阶段，所以目前只有几百个标签有文档。对于每个标签，文档按主题进行组织。主题中包含解释主题的示例，接下来是语法、参数和说明等部分。举例来说，目前，Java语言标 签的主题数量最多（已有90个，还在增长中），包括数组、流、字符串、泛型、Lambda表达式等等。数组主题包括15个示例，展示如何创建、排序、迭 代、比较、转换或者执行其他数组操作。通常，每个示例都会包含一些文本和代码片段，说明相应技术特性的使用方法。语法部分包含简明的语法参考文档，而参数 部分可以包含有关构造函数或方法参数的信息。说明部分是可选的。
Documentation向希望做出贡献或提供反馈的所有人开放。该网站还配备了一个投票系统，可以让一些示例比其他示例更受欢迎。现有的Q&A徽章和声誉会扩展到Documentation，从两个网站累积分数。
多家科技公司的开发人员已经参与进来，帮助Documentation进行改善，包括Microsoft、Xamarin、PayPal、Meteor、Dropbox等等。希望未来有许多其他的公司参与进来，为Stack Overflow贡献针对自家技术的手册。
文章转载自 开源中国社区[http://www.oschina.net]
时间： 2024-11-03 19:48:54