Reflecting django docs in pydocs
|Reported by:||nyxtom@…||Owned by:||nobody|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
First, let me say that I love django's documentation. What creates a disconnect for me is finding out how to do something very quickly. A lot of times, this is helped through pydocs and poking around various libraries using bpython. A lot of functions use kwargs, so unfortunately while the django documentation might show a signature to accept a 'mimetype' parameter, it isn't necessarily noticed from the pydocs.
It would be extremely helpful to have some signatures documented in pydocs as well as providing a link to django docs. Having the link will help in being able to see examples and search other code very quickly.