[Doc-SIG] introducing the experimental pyref wiki
Fredrik Lundh
fredrik at pythonware.com
Sun Apr 30 08:40:28 CEST 2006
(reposted from python-dev)
the pytut wiki (http://pytut.infogami.com/) has now been up and
running for one month, and has seen well over 250 edits from over
a dozen contributors.
to celebrate this, and to exercise the toolchain that I've deve-
loped for pytut and pyfaq (http://pyfaq.infogami.com/), I spent
a few hours putting together a hyperlinked mashup of the language
reference and portions of the library reference:
http://pyref.infogami.com/
a couple of notes:
- all important "concepts" have unique URLs: this includes key-
words, types, special methods and attributes, statements,
builtin functions, and exceptions.
- the conversion and structure is a bit rough; especially the
syntax/data model/execution model parts needs some serious
refactoring. the "concept pages" are in a lot better shape.
- registered users can add comments to all pages (editing is
currently "by invitation only"; mail me your infogami account
if you want to help!)
- the documentation style used at the pyref site is tuned for
authoring; an "end-user rendering" for python.org can look a
lot different. (all three sites can be made available in
glorious XHTML for inclusion in arbitrary toolchains).
enjoy!
</F>
More information about the Doc-SIG
mailing list