July 20, 2003
2:44 p.m.
[Armin Rigo Sat, Jul 19, 2003 at 07:38:39PM +0200]
Hello Holger,
Is there a standard way to write documentation attached to a source file? Should we have doc/doc_xxx.txt files just like we have test/test_xxx.py files for each source file xxx.py? Or should we have a subtree of the top-level doc/ that mimics the pypy/ subtree?
One possibility is to set a "pypy:doc" property to contain a list of related/dedicated documents. This also would allow sticking documents to directories which might be what we usually want. cheers, holger