← Back to team overview

brewtarget-devs team mailing list archive

Re: A suggestion for better manuals.- Blueprint


I think this is fantastic. Great work! I am curious: can you explain in a
little more detail how you envision the translation process? Can we have
one repo for the documentation, and one branch per language?

On Sun, Feb 15, 2015 at 2:07 PM, Maxime Lavigne <duguigne@xxxxxxxxx> wrote:

> Hi everyone,
> I am sending this email since I am not sure how to insert comments in a
> Blueprint and Launchpad expired my question.
> As you may know, I made a proposition to move towards another process for
> editing, contributing and generating user manuals for Brewtarget. More
> information can be found on the blueprint page :
> https://blueprints.launchpad.net/brewtarget/+spec/asciidoc-manuals.
> I now moved forward and tried a test implementation of what the manual
> could look like if converted to the format I am proposing. In order to put
> in place this process, I create another repository that will be removed if
> we move forward with this solution.
> https://www.gitorious.org/brewtarget-manuals
> There should be one additional repository inside the Brewtarget project
> for each language we want our manual to be translated in.
> You may look at three different output :
>   * pdf :
> https://www.gitorious.org/brewtarget-manuals/brewtarget-manuals/raw/386da8a85acdf31278537c6439f3863c2eed05e4:brewtarget.pdf
>   * epub :
> https://www.gitorious.org/brewtarget-manuals/brewtarget-manuals/raw/386da8a85acdf31278537c6439f3863c2eed05e4:brewtarget.epub
>   * html : Download the brewtarget.html file and open it in a browser.
> For an overview of the content (which is almost exactly the same) go to
> any page in the book folder.
> Let's discuss this!
> Cheers,
> malavv
> --
> Mailing list: https://launchpad.net/~brewtarget-devs
> Post to     : brewtarget-devs@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~brewtarget-devs
> More help   : https://help.launchpad.net/ListHelp

Dr. Philip G. Lee

Follow ups