On Thursday 06 October 2011 09:03:26 Benji York wrote: > I have never gotten much out of API documentation, especially generated > API documentation. I can read the code about as quickly as I can read > API docs and reading code makes it easier to drill down into the > contents of a function/method when the need arises.
I think we're conflating two types of documentation here, api docs and conceptual docs. I think we should continue with the current way that we use for api docs; that is docstrings and pydoc. J _______________________________________________ Mailing list: https://launchpad.net/~launchpad-dev Post to : launchpad-dev@lists.launchpad.net Unsubscribe : https://launchpad.net/~launchpad-dev More help : https://help.launchpad.net/ListHelp
