Comments on: Does Your Documentation Suck? http://blog.lugiron.com/2009/05/does-your-documentation-suck/ Social Media Analytics Done Right Fri, 23 Apr 2010 22:30:10 +0000 http://wordpress.org/ hourly 1 By: 30 delicious content strategy and content marketing links « new media mentality http://blog.lugiron.com/2009/05/does-your-documentation-suck/comment-page-1/#comment-69 30 delicious content strategy and content marketing links « new media mentality Tue, 14 Jul 2009 07:38:43 +0000 http://blog.lugiron.com/?p=145#comment-69 <p>[...] http://www.niemanlab.org/2009/04/managing-the-content-cascade/ [...]</p> [...] http://www.niemanlab.org/2009/04/managing-the-content-cascade/ [...]

]]> By: Twitted by rahelab http://blog.lugiron.com/2009/05/does-your-documentation-suck/comment-page-1/#comment-67 Twitted by rahelab Thu, 09 Jul 2009 00:58:21 +0000 http://blog.lugiron.com/?p=145#comment-67 <p>[...] This post was Twitted by rahelab [...]</p> [...] This post was Twitted by rahelab [...]

]]> By: lugiron http://blog.lugiron.com/2009/05/does-your-documentation-suck/comment-page-1/#comment-129 lugiron Thu, 14 May 2009 07:09:14 +0000 http://blog.lugiron.com/?p=145#comment-129 Sandra, with a naive search its not hard to narrow it down, you simply show them the most recent version of the document. I've found that most people will include the version in their search as well and by doing so they can be given the version of the document they need. It's certainly a consideration, but today's search technology makes it a fairly straightforward problem to solve for the primary use case, IMO. Sandra, with a naive search its not hard to narrow it down, you simply show them the most recent version of the document. I've found that most people will include the version in their search as well and by doing so they can be given the version of the document they need. It's certainly a consideration, but today's search technology makes it a fairly straightforward problem to solve for the primary use case, IMO.

]]> By: lugiron http://blog.lugiron.com/2009/05/does-your-documentation-suck/comment-page-1/#comment-25 lugiron Thu, 14 May 2009 02:09:14 +0000 http://blog.lugiron.com/?p=145#comment-25 Sandra, with a naive search its not hard to narrow it down, you simply show them the most recent version of the document. I've found that most people will include the version in their search as well and by doing so they can be given the version of the document they need. It's certainly a consideration, but today's search technology makes it a fairly straightforward problem to solve for the primary use case, IMO. Sandra, with a naive search its not hard to narrow it down, you simply show them the most recent version of the document. I've found that most people will include the version in their search as well and by doing so they can be given the version of the document they need. It's certainly a consideration, but today's search technology makes it a fairly straightforward problem to solve for the primary use case, IMO.

]]> By: Sandra Durham http://blog.lugiron.com/2009/05/does-your-documentation-suck/comment-page-1/#comment-24 Sandra Durham Wed, 13 May 2009 21:01:56 +0000 http://blog.lugiron.com/?p=145#comment-24 Major problem w/ multiple versions of a document - google will pick up ALL the versions on a search. How does the intrepid user narrow the field? That's a big search issue. It's great when search picks up 4-5 good hits, but when it picks up 200+? oi. Major problem w/ multiple versions of a document – google will pick up ALL the versions on a search. How does the intrepid user narrow the field? That's a big search issue. It's great when search picks up 4-5 good hits, but when it picks up 200+? oi.

]]> By: Does Your Documentation Suck? Writer River http://blog.lugiron.com/2009/05/does-your-documentation-suck/comment-page-1/#comment-23 Does Your Documentation Suck? Writer River Wed, 13 May 2009 14:37:25 +0000 http://blog.lugiron.com/?p=145#comment-23 <p>[...] Does Your Documentation Suck? Louis Marascio | May 13, 2009 | permalink Tags: community, online documentation, user experience   [...]</p> [...] Does Your Documentation Suck? Louis Marascio | May 13, 2009 | permalink Tags: community, online documentation, user experience   [...]

]]> By: hans http://blog.lugiron.com/2009/05/does-your-documentation-suck/comment-page-1/#comment-21 hans Tue, 12 May 2009 12:42:56 +0000 http://blog.lugiron.com/?p=145#comment-21 Thank you for your great help. Thomas downloaded Atlassian Confluence. It looks very good to us.<br>hans Thank you for your great help. Thomas downloaded Atlassian Confluence. It looks very good to us.
hans

]]> By: marascio http://blog.lugiron.com/2009/05/does-your-documentation-suck/comment-page-1/#comment-16 marascio Thu, 07 May 2009 19:46:37 +0000 http://blog.lugiron.com/?p=145#comment-16 Definitely, Atlassian is doing a great job. Confluence does a nice job of making sure the content is easily indexed by Google, especially with their friendly page names. I've also heard good things about the Django and PHP documentation. Definitely, Atlassian is doing a great job. Confluence does a nice job of making sure the content is easily indexed by Google, especially with their friendly page names. I've also heard good things about the Django and PHP documentation.

]]> By: John Allen http://blog.lugiron.com/2009/05/does-your-documentation-suck/comment-page-1/#comment-15 John Allen Thu, 07 May 2009 16:14:13 +0000 http://blog.lugiron.com/?p=145#comment-15 I can recommend Confluence for docs, as a heavy (and happy) user of Atlassian products I am always hitting them but always via google - just today I forgot the Confluence blog macro syntax, type 'confluence blog macro' into google (admittedly a pretty spot on term) and top link is to their real docs, delivered by Confluence itself. I can recommend Confluence for docs, as a heavy (and happy) user of Atlassian products I am always hitting them but always via google – just today I forgot the Confluence blog macro syntax, type 'confluence blog macro' into google (admittedly a pretty spot on term) and top link is to their real docs, delivered by Confluence itself.

]]> By: marascio http://blog.lugiron.com/2009/05/does-your-documentation-suck/comment-page-1/#comment-13 marascio Wed, 06 May 2009 15:30:47 +0000 http://blog.lugiron.com/?p=145#comment-13 Thomas,<br><br>It sounds like what you need is an internal wiki. Check out Atlassian Confluence, PB Wiki, or an open source wiki like TWiki or MediaWiki. Thomas,

It sounds like what you need is an internal wiki. Check out Atlassian Confluence, PB Wiki, or an open source wiki like TWiki or MediaWiki.

]]>