[IAEP] [SoaS] Sugar on a Stick Documentation Joins the Stage

Sebastian Dziallas sebastian at when.com
Wed Feb 17 10:40:29 EST 2010


Sebastian Dziallas wrote:
> Martin Langhoff wrote:
>> On Wed, Feb 17, 2010 at 3:53 PM, Sebastian Dziallas<sebastian at when.com>   wrote:
>>> I've taken some hours last weekend to spend some time to finally get
>>
>> Very cool. What's the build line? I perused the XML looking for "how
>> to reproduce soas builds" ;-) but it's understandably not there yet.
>
> Hehe! :)
>
> That should be: publican build --format=html --lang=en-US
>
> publican lives here: https://fedorahosted.org/publican/
>
>> The documentation I did read is very good -- but there is something
>> makes I wonder about -- what's the advantage of this over a wiki? The
>> barriers of entry to editing this guide are *very* high, specially for
>> documentation people...
>
> Yeah, I see that point clearly. I believe the major advantages for using
> this over wikis when creating guides or release notes is that we can
> create a variety of formats just by adjusting one line (i.e. try
> s/html/pdf or s/html/epub) and the ability to translate it easily.
>
> Translating stuff in the wiki sucks. Admittedly, I'm no translator nor
> have I tried it with publican, yet. But from looking at how Fedora's
> doing it, it should be pretty straight forward.
>
>> (I am a formet git developer, and have no prob with docbook... but I
>> still find wikis more inviting...)
>
> Yup, they're certainly more inviting. Heh, I'm not even really
> experienced with docbook and figured most of the stuff out last weekend.
>
> So what I think might be reasonable would be to use the wiki as the
> source for content, where thoughts are gathered and stuff, and to create
> the actual guides which are published later using publican.

...actually, kudos to quaid for this idea. :)

--Sebastian

> --Sebastian
>
>> cheers,
>>
>>
>>
>> m
> _______________________________________________
> SoaS mailing list
> SoaS at lists.sugarlabs.org
> http://lists.sugarlabs.org/listinfo/soas


More information about the IAEP mailing list