Comments on: Requirements docs: Goodbye word processor, hello wiki http://productvision.org/blog/bye-wp/ Articles about Product Vision and Strategy by D. Philip Haine Mon, 05 Apr 2010 20:04:04 +0000 http://wordpress.org/?v=2.9.2 hourly 1 By: admin http://productvision.org/blog/bye-wp/comment-page-1/#comment-4845 admin Thu, 13 Aug 2009 17:07:05 +0000 http://productvision.org/blog/?p=394#comment-4845 Thanks, Ken, Those are great points. I wonder whether/how Google Wave is going to deal with problem #1. Phil Thanks, Ken,

Those are great points.

I wonder whether/how Google Wave is going to deal with problem #1.

Phil

]]> By: Ken Krugler http://productvision.org/blog/bye-wp/comment-page-1/#comment-4844 Ken Krugler Thu, 13 Aug 2009 16:50:41 +0000 http://productvision.org/blog/?p=394#comment-4844 Hi Philip, I've used Confluence for a few years, and like it. The integration with Jira (issue tracking) makes it easier to move from a spec to specific actions. Two problems I've run into with wiki-based specs: 1. Discussions get awkward. With a spec doc, people send you their input and you merge it in (or not). But on the wiki you wind up with huge, threaded discussions that eventually need to get deleted (can raise hackles), or they'll continue to persist and thus distract/confuse readers when the issues they raise have been addressed. 2. Old specs never die. It's hard to know when a page is active, or done, or so far out of date it's useless. People stumble across fusty specs and assume they're gospel. It takes a lot of discipline to properly archive/flag older stuff. -- Ken Hi Philip,

I’ve used Confluence for a few years, and like it. The integration with Jira (issue tracking) makes it easier to move from a spec to specific actions.

Two problems I’ve run into with wiki-based specs:

1. Discussions get awkward. With a spec doc, people send you their input and you merge it in (or not). But on the wiki you wind up with huge, threaded discussions that eventually need to get deleted (can raise hackles), or they’ll continue to persist and thus distract/confuse readers when the issues they raise have been addressed.

2. Old specs never die. It’s hard to know when a page is active, or done, or so far out of date it’s useless. People stumble across fusty specs and assume they’re gospel. It takes a lot of discipline to properly archive/flag older stuff.

– Ken

]]> By: admin http://productvision.org/blog/bye-wp/comment-page-1/#comment-4602 admin Wed, 29 Jul 2009 17:54:16 +0000 http://productvision.org/blog/?p=394#comment-4602 Tab, I'm glad to hear it was useful. And thanks for the pointers to alternate wikis! - Philip Tab, I’m glad to hear it was useful.

And thanks for the pointers to alternate wikis!

- Philip

]]> By: Tab Hockamier http://productvision.org/blog/bye-wp/comment-page-1/#comment-4598 Tab Hockamier Wed, 29 Jul 2009 15:40:14 +0000 http://productvision.org/blog/?p=394#comment-4598 I have recently installed MediaWiki on a local site and it works very well. I have also found MoinMoin to be an excellent choice as I have used that for years. DokuWiki is very nice as well. Thanks for the article - it has help me to push the MediaWiki solution in-house to gain acceptance. I have recently installed MediaWiki on a local site and it works very well. I have also found MoinMoin to be an excellent choice as I have used that for years. DokuWiki is very nice as well.

Thanks for the article – it has help me to push the MediaWiki solution in-house to gain acceptance.

]]> By: Benji York http://productvision.org/blog/bye-wp/comment-page-1/#comment-3640 Benji York Tue, 23 Jun 2009 14:01:36 +0000 http://productvision.org/blog/?p=394#comment-3640 MoinMoin is a pretty good choice. It includes a WYSIWYG editor for non-technical types and reStructured Text (http://docutils.sourceforge.net/rst.html) support for those that need a bit more sophistication. MoinMoin is a pretty good choice. It includes a WYSIWYG editor for non-technical types and reStructured Text (http://docutils.sourceforge.net/rst.html) support for those that need a bit more sophistication.

]]>