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贡献针对自家技术的手册。
查看英文原文:Stack Overflow Launches Documentation Beta