Modules to import in documentation
|Reported by:||krister.svanlund@…||Owned by:||nobody|
|Has patch:||no||Needs documentation:||no|
|Needs tests:||no||Patch needs improvement:||no|
The django documentation is very useful in a lot of ways but in my opinion there is a problem when using it for reference. The module an object belongs to is not printed out anywhere near it (except in some cases where it is mentioned in the description). This makes it much harder than it should have to be to use the django manual for reference. Today I learned that the module is actually written out in the permalink for the object so the data is apparently available when generating the docs.
My suggestion is that the documentation is changed so that objects mentioned also clearly shows which module it belongs to without requiring hovering and mentally parsing url. An alternative solution would be to print this information in the beginning of a page on a form similar to "The following objects belong to the module xxx.xxx.xxx if not otherwise specified." I see the later suggestion as less satisfactory, both due to it being printed separate from the actual object of interest and that I believe it would take a lot more work to implement.