On 02/20/2012 04:08 PM, Bastien wrote:
Hi Simon,
Simon Schampijer<si...@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@lists.sugarlabs.org
http://lists.sugarlabs.org/listinfo/sugar-devel
