Kevin Dangoor, el lunes 23 de enero a las 16:31 me escribiste: > > PythonDoc looks good to me. I'm quite comfortable with the JavaDoc style > > (and much prefer my doc comments to occur before the entity rather than > > the pythonic doc string). I'd be happy to update Identity and Visit to > > support PythonDoc. > > docstrings are still good. They're useful for the pydoc command line > tool and help() itnerpreter function. It's just nice to be able to > provide some structured information about what the parameters are, > what the return values are and to be able to link to the other parts > of the documentation easily.
I don't know any utility for python API documentation generation to recomend, but I think it should be a lot nicer to have all the documentation in the python docstrings, just for DRY. -- Leandro Lucarella (luca) | Blog colectivo: http://www.mazziblog.com.ar/blog/ .------------------------------------------------------------------------, \ GPG: 5F5A8D05 // F8CD F9A7 BF00 5431 4145 104C 949E BFB6 5F5A 8D05 / '--------------------------------------------------------------------' TIGRE SE COMIO A EMPLEADO DE CIRCO: DETUVIERON A DUEÑO Y DOMADOR -- Crónica TV
