Comments on: Anne Gentle: Are wikis good for creating manuals and e-books? http://www.teleread.org/blog/2008/01/03/anne-gentle-are-wikis-good-for-creating-manuals-and-ebooks/ News & views on e-books, libraries, publishing and related topics Thu, 08 Jan 2009 13:26:33 +0000 http://wordpress.org/?v=2.7 hourly 1 By: Bill from Atlassian http://www.teleread.org/blog/2008/01/03/anne-gentle-are-wikis-good-for-creating-manuals-and-ebooks/comment-page-1/#comment-997656 Bill from Atlassian Mon, 05 Jan 2009 22:13:55 +0000 http://www.teleread.org/blog/2008/01/03/anne-gentle-are-wikis-good-for-creating-manuals-and-ebooks/#comment-997656 Thanks for the pragmatic tips. It seems like 90% of the effort in using a wiki for tech writing lies in finding the right set of features that support your process and formats. BTW, we're having a <a href='http://tr.im/2rhe' rel="nofollow">webinar</a> on Jan 15 showing how OpenCloud uses wikis for technical documentation if anyone is interested in attending. Thanks for the pragmatic tips. It seems like 90% of the effort in using a wiki for tech writing lies in finding the right set of features that support your process and formats. BTW, we’re having a webinar on Jan 15 showing how OpenCloud uses wikis for technical documentation if anyone is interested in attending.

]]> By: Notional Slurry » links for 2008-01-10 http://www.teleread.org/blog/2008/01/03/anne-gentle-are-wikis-good-for-creating-manuals-and-ebooks/comment-page-1/#comment-686592 Notional Slurry » links for 2008-01-10 Thu, 10 Jan 2008 06:29:49 +0000 http://www.teleread.org/blog/2008/01/03/anne-gentle-are-wikis-good-for-creating-manuals-and-ebooks/#comment-686592 [...] Anne Gentle: Are wikis good for creating manuals and ebooks? | TeleRead: Bring the E-Books Home (tags: collaboration documentation wiki publishing print books) [...] [...] Anne Gentle: Are wikis good for creating manuals and ebooks? | TeleRead: Bring the E-Books Home (tags: collaboration documentation wiki publishing print books) [...]

]]> By: adam http://www.teleread.org/blog/2008/01/03/anne-gentle-are-wikis-good-for-creating-manuals-and-ebooks/comment-page-1/#comment-682267 adam Fri, 04 Jan 2008 14:10:23 +0000 http://www.teleread.org/blog/2008/01/03/anne-gentle-are-wikis-good-for-creating-manuals-and-ebooks/#comment-682267 Very good write up and reflects some of the experience we have with FLOSS Manuals very closely. On the issue of % of contributors. We are trialling a 'book sprint' model for bringing people together in real space for intensive working periods. It will be interesting to see if this increases the ongoing online collaboration between writers. Very good write up and reflects some of the experience we have with FLOSS Manuals very closely.

On the issue of % of contributors. We are trialling a ‘book sprint’ model for bringing people together in real space for intensive working periods. It will be interesting to see if this increases the ongoing online collaboration between writers.

]]> By: Mike Cane http://www.teleread.org/blog/2008/01/03/anne-gentle-are-wikis-good-for-creating-manuals-and-ebooks/comment-page-1/#comment-681893 Mike Cane Thu, 03 Jan 2008 22:38:50 +0000 http://www.teleread.org/blog/2008/01/03/anne-gentle-are-wikis-good-for-creating-manuals-and-ebooks/#comment-681893 Hmmm... maybe a link of interest? http://my-ecoach.com/online/webresourcelist.php?rlid=4992 Hmmm… maybe a link of interest?

http://my-ecoach.com/online/webresourcelist.php?rlid=4992

]]> By: Anne Gentle http://www.teleread.org/blog/2008/01/03/anne-gentle-are-wikis-good-for-creating-manuals-and-ebooks/comment-page-1/#comment-681887 Anne Gentle Thu, 03 Jan 2008 22:07:48 +0000 http://www.teleread.org/blog/2008/01/03/anne-gentle-are-wikis-good-for-creating-manuals-and-ebooks/#comment-681887 Great write-up Robert. I especially appreciate the compare/contrast for experts vs non-experts authoring a wiki - approaching knowledge with a fresh perspective is an excellent way to populate the beginning content, and the collaborative nature of a wiki lends itself well to the first-draft-then-revise writing method. The newbie scenario held true for my contributions to the OLPC wiki - I knew next to nothing going in, and that newbie perspective was valuable. Just wanted to say thanks for offering more food for thought! It's such a fascinating subject, wikis for documentation. Stewart Mader (of wikipatterns) and I are hoping to present at DocTrain in Vancouver in May 2008. We're offering perspectives on how well wikis can (or should) be structured and which content is then your "source" - the wiki or the structured document (like DITA XML?) You'd enjoy it! Great write-up Robert. I especially appreciate the compare/contrast for experts vs non-experts authoring a wiki - approaching knowledge with a fresh perspective is an excellent way to populate the beginning content, and the collaborative nature of a wiki lends itself well to the first-draft-then-revise writing method. The newbie scenario held true for my contributions to the OLPC wiki - I knew next to nothing going in, and that newbie perspective was valuable.

Just wanted to say thanks for offering more food for thought! It’s such a fascinating subject, wikis for documentation. Stewart Mader (of wikipatterns) and I are hoping to present at DocTrain in Vancouver in May 2008. We’re offering perspectives on how well wikis can (or should) be structured and which content is then your “source” - the wiki or the structured document (like DITA XML?) You’d enjoy it!

]]>