JBoss.ORG: Content & Documentation

March 26th, 2007

Tomek and Mark are working together to figure out our wiki/CMS strategy. Ultimately, we have the use-cases of

  • Easy-to-use for developers & community members
  • Freakin’ pretty to look at
  • Browsable through a portlet on jboss.org
  • Versioned (just like the code it matches)
  • Multiple formats (HTML, PDF)
  • Multiple languages

We’re not sure what form this will all take, but it’s the goal.

We have the Red Hat Content Services team available to us, to do localizations. That gives us the possibility of proof-read documentation in 7 languages. Not too shabby.

Of course, their tooling works with DocBook. Some projects certainly might be happy with DocBook, but those preferring the wiki for documentation authoring, the .ORG team will bridge the gap with the Content Services team.

content-localization.png

Wikis many times turn into a morass of muck. Mark and I will concentrate on organizing, grooming and helping to write the docs for the .ORG projects. Good docs promote good community.

Posted in , ,

2 Responses to “JBoss.ORG: Content & Documentation”

  1. 1 Aleksandar Kostadinov
    March 27th, 2007 at 3:19 am

    TWiki is great.

  2. 2 Sergiu Dumitriu
    March 28th, 2007 at 4:39 pm

    XWiki ( http://www.xwiki.org/ ) is even better.

Leave a Reply