编码标准维基

在我的工作地点,我一直负责创建编码标准文档。 通常我们会遵循FxCop和StyleCop工具在某种程度上报告的内容,但我们真正需要的是文档,它将解释何时使用约定,为什么甚至是一个简单的例子。

这可以在将来扩展用于其他目的。

我想到的第一件事是建立一个内部维基站点,我们可以随着时间的推移轻松地建立和改变,但我以前从未使用过基于维基的引擎,并且想要一些建议。

如果可能,引擎应该在C#中,因此我们可以根据需要调整它以满足我们的需求。

如果您认为维基解决方案是错误的方法,请提供替代:)


更新

我刚刚被告知,虽然我们确实有一个它不会留下的php服务器,所以我担心基于php的wiki想法已经不在了。


更新2

您是否也可以(如果可能)告诉我这些解决方案是否适用于Active Directory?

干杯托尼

ScrewTurn Wiki是一个免费的开源wiki,用C#和ASP.Net制作。 可以使用不同的数据库后端,如MSSQL和MySQL,但也可以在没有任何数据库的情况下工作。 它有几个插件可以与Active Directory一起使用。

Mindtouch Deki

伟大的wiki,它基于C#和PHP构建,因此您可以在Mono或.NET上使用它。它还具有Active Directory集成。

下载即用型VMware映像。 它开始在我自己的PC上使用它,然后在准备就绪时将其移动到公司的VMware服务器。

我们在我的商店里有一个内部wiki,它几乎包含了我们所有的文档(不仅仅是编码标准)。 我们并没有真正看到需要自己动手,所以我们只使用了MediaWiki ……

我们使用JAMWiki并喜欢它。

它是一个可靠的应用程序,我们只与应用程序和开发人员进行了良好的交互。

你维护代码的人在回答问题和帮助用户方面做得很好。

Brad Abrams发布了一套在线C#编码标准:

http://blogs.msdn.com/brada/articles/361363.aspx

如果您转到Microsoft ASP.NET站点的入门工具包部分,您将找到几个要下载的wiki,如ScrewTurn和Flexwiki。 根据它的声音,维基将是您的需求的理想选择:-)

我是第二个MediaWiki。 它不是C#,但它可以成为通过后门隐藏一些免费软件的好借口。

如果你们是微软的商店,并且正在使用Sharepoint,它有一些内置的wiki-esquefunction。

在我开发的一个项目中,我为开发文档设置了一个MediaWiki wiki,并为在线帮助设置了一个。

我甚至可以直接从源代码和数据库生成部分开发文档。

在商店,我在他们使用的商业包非常好: Confluence 。 特别好的是它与LDAP / AD集成,因此您不需要单独登录,而且它的构建特别考虑到了业务用途,并且有很多免费插件。 没有它我们就活不下去。

当你说你没有php服务器时,我很尴尬。 它运行在人类已知的每个平台上。 我注意到大多数Visual Studio开发人员都不知道PHP在IIS上运行。

我会选择mediawiki它有最大的function集和为它开发的大多数附加组件,以防你需要将数据移植到其他地方。 如果你需要修改你的维基,你做错了。