Wiki：如何写出一篇很棒的 Wiki 文章

· 文章的类型

有许多方法都可以用来撰写 Wiki 文章。本文介绍在 Wiki 中撰写文章的最佳方法并以身作则。

若要发布一篇文章，请单击右侧的链接或单击此处。

如何写出一篇很棒的 Wiki 文章

一篇很棒的 Wiki 文章应该在标题和第一段就向读者提供所需的一个或多个信息价值点。如果您的目的是介绍如何在一个特定的环境中部署某个功能，则您的文章应该简洁扼要地介绍该环境和先决条件、列出所需步骤并描述最终状态，同时根据需要辅之以关系图、视频和其他支持材料，以便读者可以完成该任务。

如何写出一篇很棒的 Wiki 文章：

确定您想要分享的一个或两个主要的信息价值点。
为标题中的价值点奠定基础：如何表述 <价值点>、<价值点> 疑难解答、将 <价值点> 与 <其他产品> 关联起来、<价值点> 入门等。
在开头的段落确立文章的期望。您是演练如何使用一个 64 位计算机的群集将 SQL Server 2008 安装到一个群集环境、介绍两个功能之间的互操作特性、论述与另一个函数相比调用一个 API 函数的优缺点、为产品或功能提供故障排除步骤还是论述某个实现方式的一般特性？读者想要知道期望是什么。
以简洁的方式撰写。长文章不见得是好文章。如果用 20 个字就可以提供信息价值点，那 20 个字就够了。
有自己的风格，但要简明。我们不是“机器人”，应该有自己的想法和观点。要有您自己的风格，但不要喧宾夺主。要保护信息价值点！
在标题和正文中使用与价值点有关的关键字。还没有很好的搜索引擎优化技术，搜索引擎只知道您的关键字并使用它们。
根据需要提供引证。引证可以提供可靠性、权威性、其他观点、更多的细节，并且常常会提高文章的信誉。
有自己的见解并且表达出您的见解。如果您偏爱某个特定的部署解决方案，则描述您探索出的方法以及偏爱原因。为什么与调用其他函数相比您喜欢调用某一 API 函数？告诉我们原因！这可能对您来说看起来不重要，但读者想知道。
寻求您想要的帮助。如果您希望读者添加更多的应用场景、脚本或其他信息，那就让他们知道。
大胆地贡献，客气地编辑。您可能是文章的创建者，但一旦发布后，文章即为社区所拥有。如果拼写和语法不完美，社区会逐步改进和完善。
关联文章。如果适合，可链接到您的文章或者从您的文章链接到其他网页，从而轻松地进行访问。

如果您满足了需要，读者将会找到您的文章。

文章的类型

您的文章可以填补许多不同类型的需求。下面是您可能会发现的几种类型的需求：

讨论。此类型的文章展现不同的选项、意见和观点。如果读者对某个观点有不同意见，可以将自己的想法和见解作为“其他意见”添加到现有意见中。目标是从所有角度阐明观点。示例。
概要说明。目标是介绍产品、理论或一般概念的概要情况。如果形成了大量的小节内容，则另起一篇新文章并且链接到这篇文章。示例。
操作指南。此类型的文章尽可能简洁明了地提供说明。示例：如何添加视频或图像。
存根。由您开始并且将需要展开的一种简短的文章。创建存根。也许您没有时间或知识来写完整篇文章，但您希望能在以后完成它或社区将帮助您完成它。示例。
链接集合。主要是链接的集合的一种文章。此类文章可以是 wiki 门户（其中，所有链接都指向 TechNet Wiki 中的其他主题）或外部链接的集合（或组合）。请确保链接是否指向其他 wiki 文章清晰明确。示例：入门 , 产品和相关主题的列表。
故障排除。在使用特定的产品或界面时遇到的常见问题的解决方法的列表。示例。