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 贡献针对自家技术的手册。
评论