Hi folks,
Armin and me have spent today on largely reworking and
refactoring PyPy's documentation. On
http://codespeak.net/pypy/index.cgi?doc
you'll see a cleaned up entry page and navigation bar,
and much cleaned up and cross-referenced content.
Moreover, the integrity of the links in the ReST files
are now checked within our testing process. If you issue::
python test_all.py documentation
then ReST-checks as well as link checks are performed. If you
provide the '-R' option then also all remote links are checked
for existence. Running 'py.test' or 'python test_all.py' in
the pypy directory will run the non-remote documentation
checks by default.
Our documentation rework should provide a good basis for
continued updating and improvement of the documentation.
Btw, there is a 'redirections' file which contains a mapping
from old names to new names/locations which the web site uses
to map old URLs to new places (via a Redirect). Try e.g.:
http://codespeak.net/pypy/index.cgi?doc/howtopypy.html
or any other old URL.
Feedback (and helping with improving the documentation further)
is very welcome!
cheers,
holger
_______________________________________________
[email protected]
http://codespeak.net/mailman/listinfo/pypy-dev
