Just FYI, URL has changed and docs are updated:

http://pyogp.net/docs/pyogp.lib.base/

-- Christian


Christian Scholz schrieb:
Hi!

I've Updated PJira Issue PYO-3 ( http://jira.secondlife.com/browse/PYO-3 ) so that it's easier for you to track, add and work on Documentation 'Issues'
outlined here -
https://wiki.secondlife.com/wiki/User:Enus_Linden/Project-Wiki-Structure

This way all of the 'issues' are separate and can be Updated, assigned and
Resolved that way.
Hopefully this will lighten your load slightly and make things a little
easier for you! : D

It makes at least clearer what the load is so thanks for organizing it! :)

I also discussed with Enus yesterday if we maybe should use Sphinx for documentation. It is reStructured text based and rather easy to write. The docs will reside on the filesystem and thus in svn which makes them also versioned which is good I think. They can also contain example code in doctest format so that we can even automatically test the documentation and get informed if it does not match the code anymore. I think it also might make it easier to stay in one place and be exported from there. At least for me it makes it more likely to write documentation as it's also faster than editing a wiki.

Sphinx moreover allows for various output generators like HTML, PDF and others (maybe there is even a mediawiki extension).

I made a little example here: http://pyogp.net/html

(and btw, there is a docs/ directory in pyogp.lib.base by default anyway which would ship with the package).

-- Christian

PS: And I registered pyogp.net for having a shortname for my presentation instead of the wiki link. It redirects there. I hope that's ok with everybody :)





_______________________________________________
Click here to unsubscribe or manage your list subscription:
https://lists.secondlife.com/cgi-bin/mailman/listinfo/pyogp

Reply via email to