开发人员文档:Sharepoint文档管理与ScrewTurn Wiki

Question

背景资料

我正在为我公司的开发人员设置一种方法来共享有关我们各种内部系统的文档和信息.这可能包括有助于提高新员工速度的信息,以及用户对系统及其解决方案的常见问题的描述.

对我来说这似乎是一个理想的维基工作,由于我们公司只能托管ASP.NET应用程序,所以我开始研究可用的ASP.NET wiki.ScrewTurn Wiki似乎是最合适的,它功能非常齐全,有几个可用的插件对我的情况很有用,包括语法高亮和AD集成.

然而,在启动将ScrewTurn部署到我们的Intranet的过程时,突然想起,嘿,Sharepoint 2007有一个wiki,而且由于我们已经设置了Sharepoint,我们不能只使用它吗？我对Sharepoint"wiki"进行了一些评估(在引号中,因为它几乎没有资格),并且能够证明它由于它的许多缺陷而不适合,我将不在此列出.

现在,在这一点上,有人建议我可能根本不需要维基,我们不能只在Word文档中执行所有操作并使用Sharepoint的文档管理功能吗？

实际的问题

所以我正在寻找的是一些额外的弹药,最好是有经验的人.在内部开发人员文档的上下文中,Sharepoint难以或不可能的事例是什么？什么是wiki更好？嘿,我心胸开阔,Sharepoint更好的是什么？

什么使得部署维基而不是简单地使用我们已经拥有的东西值得？

Answer 1

我希望这会有所帮助 - 加分或不加分:)

如果您正在使用Office文档,SharePoint Server(SPS)或Windows SharePoint Services(WSS)非常好 - 您可以进行版本,签入/签出,共享,搜索等.我不认为市场上有什么东西可以用来接近该功能(它也可以自定义列表和东西).

但正如你所指出的那样,WIKI功能是不合标准的.

对于开发人员文档,wiki要好得多,因为您可以轻松地链接文档,即使出于开发人员倾向于喜欢wiki标记的唯一原因!使它感觉他们正在编写代码而不是文档.好吧,好吧,我喜欢它.Word文档？无尽的挫败感,特别是对于代码snippits和像API这样的东西.Wikis'通常非常非常好地处理代码和结构化格式.

但这是我发布的主要观点:

如果你可以托管ASP.NET - 如果你有SPS,你已经可以了! - 然后只安装他们两个.创建一个新的IIS虚拟主机,将STW放入该虚拟主机('cos SPS将在其自己的虚拟主机中)*.按一下DNS(所以你可以点击http://wiki什么),然后去做吧.

由于它是贵公司内部的,STW具有Windows安全性和版本,因此安全性不是一个大问题.每个页面都可以从任何地方链接 - 毕竟它是一个HTML页面 - 所以如果你真的想要,你可以从SPS wiki链接到它.我想,有一些锁,但不是很多.

在BBC Worldwide,我们使用了许多技术:

• Atlassian Confluence(WIKI)的一些项目.我喜欢这个wiki,但它是一个很大的企业系统.
• 螺丝转一些部门内部的东西.
• Trac用于其他一些东西(其他人在我们的源代码库中使用SVN设置它,所以它使用了一点 - 它很好,我更喜欢它,但它是一个设置)
• SPS/WSS用于文档管理.

STW,Trac和SPS之间存在链接 - 例如我们尽量不将文档作为附件存储在trac中,而是在SPS中链接到它们等.

效果很好.

至于弹药:如果SPS适合你想做的事情(或者你可以适应它的功能),SPS效果很好.如果没有,你要么搞砸了,要么需要做很多开发,这真是一回事:)

但是除了管理层对它的所有有趣之外,我都看不到安装它们的问题.STW毕竟是免费的.你有服务器.

它得到了开发人员的写作文档,这很少是一件坏事.好吧,如果真正的人类必须阅读它,这是一件坏事,但对于其他开发人员而言,这是一个很好的事情吗？都好.

*注意:虚拟主机.不是虚拟的DIRECTORY.

Answer 2

我做过两件事.在那些经历之后,这是我的建议:

• 如果你需要WYSIWYG并且不关心Sharepoint的膨胀和缺乏功能(维基是简单的,但具有你在维基中需要的主要功能),那就去吧.它可以作为一个wiki,当商务人士需要点击wiki时会有所帮助 - 更少的时间教他们使用它等等.
• 如果你可以使用准系统,只想要一个快速而灵活的简单维基,你就无法击败螺旋桨.

至于使用维基的原因,无论是拧还还是共享点 - 它都会在Sharepoint中击败单词文档.要使用Sharepoint,首先必须下载文档,编辑,上传或使用最好是chancy的Office集成.Wiki消除了所有的摩擦,使其更新变得简单.消除摩擦是关键,因为当你必须使用word文档时,你最终不会像你应该那样经常更新它们.使用wiki,它是一个2秒弹出/编辑/保存事务.使用单词doc,加载单词,打开文档,编辑,担心格式化,保存等需要几分钟.

Answer 3

嘿,我在这里有经验.我们开始使用ScrewTurn,但我们被要求切换,因为该公司已经购买了SharePoint.文档质量下降是因为Word文档与wiki不匹配,正如其他人所指出的那样,SharePoint不符合标准.

在我看来,没有什么比文档更好的维基.我认为主要是能够创建到目前尚不存在的页面的链接.这样我就可以删除文档,其余的则根据需要填写.它使文档更简洁,更易读.

使用Word文档时,不太可能使用超链接,但它对文档的可读性非常有帮助.我可以继续......