We've drafted a set of (killer) tutorials for Arquillian, most notably the ever-essential Getting Started Guide. Currently, the tutorials are in English. We are now looking for translators to bring these tutorials to additional languages.

If you are willing to translate, we want to know you.

There are already translations underway of the Getting Started Guide into French, German, Portuguese and Polish (thanks Arqullian Nobles!). But there are plenty of other guides to be translated, so don't worry that we'll run out of words to translate before you can get to it!

The guides are located in the arquillian.github.com github repository (develop branch):

However, our documentation team, PressGang, still works in Docbook. Confluence exports snapshots (such as when a software release is made) into Docbook. That output is feed into the PressGang editing and translation process. JBoss hasn't given up on Docbook entirely, but rather is experimenting with a frontend that enables web-based editing.

User tutorials

This thread pertains to the user tutorials that will be integrated into the project website. Arquillian is exploring a new approach by integrating the user tutorials directly into the project site. The reasoning is that user tutorials play a critical role in communicating the value of the project and therefore need to be the first resource that a visitor sees when they come to the site. They also need to integrate well with the site because how they look (style, use of whitespace, layout) strongly influences how effective they are. One size does not fit all in this case (hence a key reason why Confluence doesn't fit here).

We decided to use textile for these tutorials for several reasons:

It minimizes the effort involved in writing because it's mostly plain text

It can be integrated tightly with the Arquillian website

It can be managed in git, so that we can easily track history

It can be automated when new releases go out using text replacement or scripting

The fact that it can be managed in git and automated should not be underestimated. This opens up a lot of possibilities about how we can manage to keep the guides updated and the translations in sync. (We could also export to Docbook if the need arises)

To wrap up:

Reference documentation is managed in Confluence and exported to Docbook

User tutorials are managed in the Arquillian website git repository, written in textile and (will be) published as part of the website

I hope that clears things up. Yes, we are trying something new, but doing something new is what leads to progress

Note that the website has not yet been published, so you won't find these user tutorials on the web (yet).

We'd be thrilled to accept your contribution of a Simplified Chinese translation!

Please feel free to contribute when it's most convenient for you. There's no strict deadline, per se. But, if you complete the Getting Started guide (the first one) by the end of the month--in time for the 1.0 release--we'd be super excited. We truly want to make this an international launch.