Adobe DITA World 2018
Stay current with the latest in tech comm
Keep current with the latest trends in technical communication by subscribing to the I'd Rather Be Writing newsletter. 4,500+ subscribers

Stitcher radio

Search results

Adobe DITA World 2018

FLOSSmanuals.net: A New Wiki Help Authoring/Publishing Tool Hybrid

by Tom Johnson on Sep 5, 2008
categories: generalwikis

Flossmanuals.net is a new wiki help authoring/publishing tool hybrid that, as far as I know, is completely unique. The site is more than a wiki. It allows groups of authors to create specific chapters independently. You can then remix the chapters into any arrangement and selection you want through a drag-and-drop interface. Finally, you can export the selection as a PDF file. Alternatively, you can embed the manual on a separate site using an API.

<>
Flossmanuals -- a site that combines a wiki with a publishing engine
Flossmanuals -- a site that combines a wiki with a publishing engine

FLOSS stands for Free/Libre Open Source Software, and this site announces itself as a host for open source software documentation ("free manuals about free software").

Why not use traditional help authoring tools? Often times open source software projects can't afford the expensive authoring tools more commonly used to document commercial software. Additionally, developers -- who often write the documentation -- don't want to learn complicated authoring tools. The wiki interface is simple yet flexible. Publishing multiple versions of guides is easy. Read more about FLOSSmanuals.net here.

In exploring the site, I think the concept is impressive. It's the next generation in wiki authoring. However, right now the site is very young. Additionally, by limiting the scope to open source, the authors limit their potential for adoption. The same software could have market appeal for commercial group authoring situations.

Anne Gentle is one of the go-to people for information on Flossmanuals. You can read the results of their "booksprint" (a long documentation writing party) on Anne's blog.

Keith Soltys wrote about Floss and linked to numerous other writers, including Charles Jeter and Janet Swisher. We also talked about FLOSSmanuals.net briefly on the last podcast.

----

Update: I just published this post and Shannon looks over my shoulder and says "Floss manuals? They teach you how to floss?"

Stay current with the latest in tech comm
Keep current with the latest trends in technical communication by subscribing to the I'd Rather Be Writing newsletter. 4,500+ subscribers

follow us in feedly
https://idratherbewriting.com/2008/09/05/flossmanualsnet-a-new-wiki-help-authoringpublishing-tool-hybrid/
idratherbewriting.com
crawl=CC-MAIN-2018-43
41092
application/http; msgtype=response
sha1:NY66G2EDDMOD32TEJKTLB3DCK3QUWCGG
<urn:uuid:07c1ef67-5cb8-4d7c-9347-0110e416d36c>
2018-10-20T18:17:29Z
104.27.149.230
text/html
sha1:HFRFCUZWBQMESFFE56WIY5MQFEWUKUSG
<urn:uuid:e218c626-a1ce-4329-bd7b-716512ff0ddb>
https://idratherbewriting.com/2008/09/05/flossmanualsnet-a-new-wiki-help-authoringpublishing-tool-hybrid/
response
<urn:uuid:bc81febb-8833-4e95-95a1-77c87024b438>
isPartOf: CC-MAIN-2018-43
publisher: Common Crawl
description: Wide crawl of the web for October 2018
operator: Common Crawl Admin (info@commoncrawl.org)
hostname: ip-10-111-241-198.ec2.internal
software: Apache Nutch 1.15 (modified, https://github.com/commoncrawl/nutch/)
robots: checked via crawler-commons 0.11-SNAPSHOT (https://github.com/crawler-commons/crawler-commons)
format: WARC File Format 1.1
conformsTo: http://iipc.github.io/warc-specifications/specifications/warc-format/warc-1.1/