brewtarget-devs team mailing list archive
-
brewtarget-devs team
-
Mailing list archive
-
Message #00179
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
www.linkedin.com/in/philipgreggorylee
Follow ups
References