Adobe Experience manager

Get new posts delivered straight to your inbox.

Subscriber count: 4,300

Stitcher radio

Search results

Adobe Experience manager A New Wiki Help Authoring/Publishing Tool Hybrid

Sep 5, 2008 • general, wikis 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 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 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?"

follow us in feedly

Get new posts delivered straight to your inbox.

Subscriber count: 4,300

About Tom Johnson

Tom Johnson

I'm a technical writer based in the California San Francisco Bay area. In this blog, I write about topics related to technical communication — Swagger, agile, trends, learning, plain language, quick reference guides, tech comm careers, academics, and more. I'm interested in simplifying complexity, API documentation, visual communication, information architecture and findability, and more. If you're a technical writer of any kind (progressional, transitioning, student), be sure to subscribe to email updates using the form above. You can learn more about me here. You can also contact me with questions.