[OLPC library] Fwd: Re: [Sugar-devel] Sugar docs

[Holt]

What can we learn from this in prep for Apr 6-10th's doc sprint??  
(http://j.mp/xomanual)
Ideally!  Not that we've yet reached the dream of all kids/users being 
developers too ;)


Subject: 	Re: [Sugar-devel] Sugar docs
Date: 	Thu, 23 Feb 2012 16:05:25 +0100
From: 	Simon Schampijer <simon at schampijer.de>
To: 	Bastien <bzg at laptop.org>
CC: 	Sugar Devel <Sugar-devel at lists.sugarlabs.org>


On 02/20/2012 04:08 PM, Bastien wrote:
>  Hi Simon,
>
>  Simon Schampijer<simon at schampijer.de>   writes:
>
>>  is this [1] the latest version of the Sugar docs? What is the current
>>  process for updates (e.g. the upcoming 0.96). Is there someone working on
>>  that end? There were questions here at the GNOME doc hackfest [2] what
>>  Sugar is doing for documentation and I am not sure if I am fully up to
>>  date.
>
>  At the SugarCamp in Paris, I brievely mentioned readthedocs:
>
>     http://readthedocs.org/
>
>  Florent Pigout told me about this service, which looks quite
>  nice.   Maybe the Sugar community could use something like this
>  instead of FlossManuals?  FM may be suitable for end-users docs
>  but not that much for developers docs.
>
>  Best,

GNOME does use mallard [1] for their documentation in the docs (yelp).
The concept of "topic-oriented" documentation is nice, I think.
Furthermore using the same tools as GNOME could help in people doing
documentation in both projects. When people want to update the current
floss manuals they could maybe evaluate this first.

We could use mallard as well for API docs, see for example Tomeu's work
on documenting the Python API docs from introspection [2], the current
API documentation looks rather outdated [3]. Would be a nice project for
someone to work on it.

Regards,
    Simon

[1] http://projectmallard.org/
[2]
http://blog.tomeuvizoso.net/2012/02/progress-on-generating-python-api-docs.html
[3] http://doc.sugarlabs.org/epydocs/
_______________________________________________
Sugar-devel mailing list
Sugar-devel at lists.sugarlabs.org
http://lists.sugarlabs.org/listinfo/sugar-devel

-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.laptop.org/pipermail/library/attachments/20120223/409cfd5e/attachment.html>