17

背景信息

我正在为我公司的开发人员建立一种方法来共享有关我们各种内部系统的文档和信息。范围从有助于使新员工加快速度的信息,到用户对系统及其解决方案的常见问题的描述。

对我来说,这似乎是 wiki 的理想工作,而且由于我们公司只能托管 ASP.NET 应用程序,因此我着手研究可用的 ASP.NET wiki。ScrewTurn Wiki似乎是最合适的一个,它功能非常齐全,并且有几个可用的插件对我的情况很有用,包括语法突出显示和 AD 集成。

然而,在开始将ScrewTurn 部署到我们的Intranet 的过程时,突然想起,嘿,Sharepoint 2007 有一个wiki,既然我们已经设置了Sharepoint,我们就不能使用它吗?我对 Sharepoint “wiki” 做了一些评估(在引号中,因为它几乎不合格),并且能够证明它不适合由于它的许多缺陷,我不会在这里列出。

现在,有人建议我可能根本不需要 wiki,我们不能只在 Word 文档中做所有事情并使用 Sharepoint 的文档管理功能吗?

实际问题

所以我要找的是一些额外的弹药,最好是有经验的人。在内部开发人员文档的上下文中,使用 Sharepoint 会遇到哪些困难或不可能的事情有哪些示例?wiki 擅长什么?嘿,我思想开放,Sharepoint 擅长什么?

是什么让部署 wiki 而不是简单地使用我们已有的东西值得?

4

11 回答 11

18

我希望这会有一些用处 - 加分与否:)

如果您正在处理办公文档,SharePoint Server (SPS) 或 Windows SharePoint Services (WSS) 非常好 - 您可以版本、签入/签出、共享、搜索等。我认为市场上没有任何东西可以接近该功能(它还可以很好地完成自定义列表和东西)。

但是正如您所指出的,WIKI 功能是不合标准的。

对于开发人员文档,wiki 更好,因为您可以轻松地链接文档,即使开发人员倾向于喜欢 wiki 标记的唯一原因!让人感觉他们在写代码,而不是文档。嗯,好的,我喜欢。Word文档?无尽的挫败感,尤其是对于代码片段和 API 之类的东西。Wiki 通常非常非常好地处理代码和结构化格式。

但这是我发帖的重点:

如果您可以托管 ASP.NET - 如果您有 SPS,那么您已经可以了!- 然后只需安装它们。制作一个新的 IIS 虚拟主机,将 STW 放入其中('cos SPS 将在它自己的虚拟主机中)*。稍微按摩一下DNS(这样你就可以点击http://wiki或其他东西),然后就去做。

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

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

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

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

效果很好。

至于弹药:如果 SPS 适合您想要做的事情(或者您可以适合 IT 做的事情),它会很好地工作。如果没有,你要么搞砸了,要么需要做很多开发,这真的是一回事:)

但是除了管理层对此感到很有趣之外,我看不出同时安装两者有什么问题。STW毕竟是免费的。您有服务器。

并且它得到了开发者的写作文档,这很少是一件坏事。好吧,如果真人必须阅读它是一件坏事,但是其他开发人员的文档呢?都好。

*注:虚拟主机。不是虚拟目录。

于 2009-03-04T15:27:53.237 回答
9

我都做过。经历了这些之后,我的建议是:

  • 如果您需要 WYSIWYG 并且不关心 Sharepoint 的臃肿和缺乏功能(wiki 很简单,但具有您在 wiki 中需要的主要功能),那就去吧。它作为一个 wiki 工作,并在业务人员需要访问 wiki 时提供帮助——教他们使用它等的时间要少得多。
  • 如果您可以使用准系统并且只想要一个快速灵活的简单 wiki,那么您将无法击败螺旋式。

至于为什么要使用 wiki,无论是螺丝转还是 sharepoint——它都胜过 Sharepoint 中的 word 文档。要使用 Sharepoint,首先您必须下载文档、编辑、上传或使用最好的 Office 集成。Wiki 消除了所有的摩擦并使更新变得非常简单。消除摩擦是关键,因为当您必须使用 word 文档时,您最终只是没有像应有的那样经常更新它们。使用 wiki,这是一个 2 秒的弹出/编辑/保存事务。使用 word doc,加载 word、打开 doc、编辑、担心格式、保存等需要几分钟。

于 2009-02-25T19:45:44.020 回答
6

嘿,我在这里有经验。我们开始在工作中使用ScrewTurn,但由于公司已经购买了SharePoint,我们被要求更换。文档质量下降是因为 Word 文档无法与 wiki 匹敌,而且正如其他人所指出的,SharePoint 的文档不符合标准。

在我看来,没有什么比 wiki 更适合文档了。我认为这主要是创建指向尚不存在的页面的链接的能力。这样我就可以删除文档,其余的根据需要填写。它使文档更加简洁和可读。

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

于 2009-03-10T20:29:13.103 回答
4

概括地说,对于技术文档来说,word 是相当糟糕的。因为它对于大型的结构化文档的效果很差,所以它鼓励了小文档的扩散,而文档之间没有交叉引用。将其放大到任何显着大小,您将很难找到与您正在尝试调查的问题相关的文档。随着时间的推移,您会发​​现人们浪费越来越多的时间在一堆乱七八糟的 word 文档、电子表格、visio 图表甚至是 powerpoint 演示文稿中寻找可能会或可能不会记录的信息。

将它们放入共享点只会迫使您通过浏览器路由搜索。

任何技术文档工具都必须支持文档之间的交叉引用以避免丢失这些引用。wiki 比 word 更能做到这一点。此外,将生成的内容(如数据字典或 API 文档)合并到 wiki 中要容易得多,并且您可以使外部参照目标稳定。

于 2009-03-04T16:06:42.910 回答
3

这是 SharePoint 的开源扩展 wiki,可能更适合:

http://www.codeplex.com/CKS/Wiki/View.aspx?title=Enhanced%20Wiki%20Edition&referringTitle=Home

于 2009-02-25T22:51:27.147 回答
2

首先,查看这个 StackOverflow 线程。一个类似的问题被问到了关于 Sharepoint wiki 的问题,赞成和反对的答案都非常有用,并概述了您问题的“在 Sharepoint 中不可能”部分。

在将 Sharepoint 用于团队文档几年之后,我现在正试图在 Sharepoint 中实现一个团队 wiki,因为他几乎和你一样。我的观察:

Sharepoint 文档库

我的经验是用于文档的 Sharepoint 是不错的。它可能很不稳定,有时您会丢失编辑或出现性能问题,尽管优秀的 Sharepoint 支持团队可以帮助解决其中的一些问题。我确实发现 Sharepoint 文档库比在网络上存储东西更好。它使文档和库易于链接。明智地使用元数据属性可以使 Sharepoint 列表视图对于查看文档的内容、用途和状态非常有用,因此我们的分析师、PM、开发人员等都一眼就知道谁拥有球和什么时候等着他们。那是几年前开始的一个项目。今天,Sharepoint 2007 的工作流程可能会提供通知。

还有文档的版本控制。但正如其他一些人所指出的那样,在文档中做事在撰写、下载和共享方面存在开销和缺陷。签出文档会有所帮助,但松散的大炮开发人员可以下载文档、编辑它们,然后将它们存储在其他地方,从而破坏版本控制。这发生在我们身上,尽管这是一个纪律问题,而不是 Sharepoint 的错。

共享点维基

根据 Chris Hynes 的回答,摩擦是描述问题的好词。为了快速参考团队内部基础设施的详细信息,wiki 似乎对我们更有效。wiki 使数据几乎立即可见,无需先单击链接并等待 Word 加载。编辑也更快更容易......虽然我仍在尝试它,但 Sharepoint wiki 具有版本控制并允许“签出”wiki 文章。

正如您和其他 SO 线程所指出的,与其他 wiki 引擎相比,Sharepoint 是轻量级的。它更擅长什么?好吧,我使用它是因为它就在那里,不需要任何特殊设置,总比没有好,坦率地说,它适用于不需要强大或面向客户的内部东西。卖给老板很容易,因为它的成本不会超过我们已经花费的成本。wiki 也不容易被我前面提到的松散大炮类型所破坏,我们可以在必要时查看审计跟踪或回滚。

添加和交叉链接条目很容易,但如果要嵌入图形,则必须先将它们上传到 Sharepoint 库。您也可以在 wiki 中编辑 HTML,尽管我不确定这样做有什么限制,并且如果没有安全访问和 Sharepoint Designer,我认为无法控制 CSS。所以除了文本(比如表格)之外的任何东西都不是很健壮。

到目前为止,我比将所有内容都存储为文档更喜欢它。查看和编辑数据的即时性为 wiki 提供了真正的优势。这肯定比拉下文档并重新签入要容易。对于一般厌恶文档的开发人员来说,它有助于消除保持信息更新的障碍。

还有其他要考虑的。您希望您的开发人员热情并积极参与编辑 wiki 吗?如果是这样,您可能需要不同 wiki 引擎的讨论功能。我的开发人员和大多数人一样;他们最讨厌的两件事是测试和文档。所以我是创建文章的人,解释构建过程、数据库环境使用、应用程序实例、服务器映射、SOX 文档清单等。其他开发人员将主要参考它并发布小的更新。我们的版本控制和并发支持并没有受到太大压力。

于 2009-03-05T02:27:01.827 回答
2

wiki 比一堆 word 文档更容易被使用,因为它比一堆 word 文档更快更容易找到编辑或创建新页面的条目!

然后问题变成了哪个wiki

几乎所有的 wiki 都比 SharePoint wiki 好,这是一个笑话

Screwturn 非常棒,在 v3 中具有 ACL 和所见即所得,并且非常容易扩展

例如,使用 XSLT 插件非常适合嵌入服务器进程、CI 构建、测试、源代码控制统计等的输出

例如,我们有一个 OLEDB 插件,它可以从各种公司数据库中读取关键值,并将它们嵌入到描述数据是什么以及它应该具有什么值的页面中。我们有一个母版页,其中列出了所有数据超出规定范围的页面。FIT 和系统监控工具的混合体

如果您对“所有内容”的管理职位必须在 SharePoint 中,那么有螺丝转插件可以将螺丝转页面呈现为 PDF、HTML、xml 等(然后您可以转换为 docx)并有一个脚本来转储更改的螺丝转每晚将页面发送到 SharePoint 以进行搜索和“管理”目的

于 2009-03-10T02:53:57.260 回答
2

您可能想查看Confluence,因为它可能是市场上领先的企业 wiki。该 wiki也有一个SharePoint 连接器。作为 SharePoint 连接器的贡献者之一,我有点偏颇,但如果您不检查现有的一些选项,您可能会对自己造成伤害。Wiki 可以强大且具有传染性,但如果 wiki 低于标准,则不会发生这种情况。

于 2009-03-10T13:47:11.073 回答
1

通过将 SharePoint wiki 与任何其他 wiki 系统进行比较,没有人会对它感到满意。

所以,不要比较。它具有 wiki 有用所必需的基本功能:您可以输入(有点)格式丰富的文本,以及指向其他页面的链接,无论它们是否存在。单击指向不存在页面的链接会将您带到新的空白页面的编辑页面,允许您保存页面。

是的,图片支持很烂。您必须先创建图片,然后粘贴图片的 URL。因此,请花两分钟时间创建一个图片库以在其中发布 wiki 图片。

记住 wiki 的主要目标 - 不是与其他 wiki 工具竞争,而是快速将想法写下来,并且不停止构建它们。结构可以稍后添加,如果有的话。

正如其他人所说,telerik 提供了富文本编辑器的替代品,有一个 CodePlex 项目正在(缓慢地)进行改进,而且,人们,它是 SharePoint——如果你不喜欢它,你可以自定义它。它是 ASP.NET、Web 服务和 Windows Workflow Foundation。

我不建议任何人出去购买 MOSS 许可证只是为了实现一个 wiki(或博客,就此而言)。但是,如果您已经拥有 SharePoint 基础结构(可能是 Visual Studio Team System Team Foundation Server 的一部分),那么就去做吧。我已经看到几个 SharePoint wiki 库用于极大地提高大型软件开发组织中的多个组可用的开发人员文档的数量和质量。一旦我们停止了关于其他 wiki 有多棒的讨论,就会有很多文档本身就发生了,就像它应该做的那样。

于 2009-03-11T03:30:04.433 回答
0

我经常使用 Sharepoint,我发现它有点慢而且很烦人。如果一切都已经是 Office 文档,并且如果您的公司愿意让每个人的计算机都与 Office 版本保持同步,那么 Sharepoint 可以正常工作。如果您有各种 Office 版本(就像我们一样),那么它就没有那么好了。我的机器有一些旧版本的办公组件,集成并不总是正常工作。我已经学会了根本不尝试使用集成。

这两种解决方案最重要的是确保您的员工知道如何使用它。我们在早期遇到了一些问题(不同名称的文件版本,而不是使用 sharepoint 中内置的版本控制),这实际上只是人们培训中的空白。

于 2009-03-04T15:37:04.573 回答
0

我们目前正在使用两者的组合,用于规范和正式文档的共享点以及用于“隐性知识”的 Wiki。我们的每个解决方案在 wiki 中都有一个页面,由于易于添加内容,这非常有效。

于 2009-03-10T11:21:19.457 回答