Dear po4a team,

I'd like to renew the workflow of the rulebook of the international unicycling federation. It's a big document (~100 pages) with competition rules for unicycling. It is constantly changing, because the sport is very young and developed a lot. Sadly there is no space for experimental rules that need to be tested first.

Right now it is written in MSWord, passed around by email and the translations are not coordinated very well. This worked out for the last 10 years, but I think today we can do much better.

How I think it should work:

- Many people should be able to write differnt parts of the document at the same time

- People need to know what changed at which time, so we need version control

- There should be versions with experimental rulesets for testing competitions

  - If an experimental rule works out, it can be merged into the master document

- The translation should be done collaboratively by the community

- people should be able to view the current versions (including translations) online and/or print them

- If a change to a master/experimental document is made, the translation system is automatically updated, so that the community can start to translate changes immediately. (No regular admin interaction)

Here are my ideas so far:

- Rewrite the whole thing in LaTeX (can render to HTML or PDF)

- Put it in a git repository and manage experimental versions as branches

- With every commit render the pdf and html versions.

- Translate it (and also the experimental branches) collaboratively with po4a and Pootle and also render the translated documents automatically

I think this could solve the issue. But before we start to work I want to know if this is the right approach. Latex and git are no problem. But for the translation I'm not sure.

With a new commit in git, we could trigger a po4a-updatepo for the changed latex files in every branch. But is it possible to automatically reinject them into Pootle? How do the translations flow back from Pootle to the build system. If a new language is set up in Pootle, how does it create new documents? Can we do version control for the languages to be able to jump back to an older version of a document with proper translation?

I guess you can answer these questions easily and support us to set this up properly.

Thanks in advance and greetings from Germany

Felix Dietze

International Unicycling Federation