Modernize some of the djblets.cache documentation.
Review Request #7371 — Created June 2, 2015 and submitted
The djblets.cache documentation was amongst the oldest sets of docs in
the codebase, and weren't anywhere close to PEP-257-compliant, nor did they
render well in our new doc builds.I've gone through and updated the public-facing documentation, making it
compliant with PEP 257 and helping it render links and text properly.
I've also fleshed out some of the documentation to clear up some points.In order to link to Django docs for some of the settings, I needed to
add a new extension, djangorefs, which sets up the cross reference types
needed.
Built the docs and read through them.
- Change Summary:
-
Added module-level docstrings.
- Commit:
-
64a8534f0421ff3925f39f1278b6be9e76d6e894ac4f0f8b9d1368bded3bf2f0cfccfa4f27fab788
-
Tool: PEP8 Style Checker Processed Files: djblets/cache/context_processors.py docs/djblets/_ext/djangorefs.py docs/djblets/conf.py djblets/cache/forwarding_backend.py djblets/cache/serials.py djblets/cache/backend_compat.py djblets/cache/backend.py Ignored Files: docs/djblets/coderef/index.rst Tool: Pyflakes Processed Files: djblets/cache/context_processors.py docs/djblets/_ext/djangorefs.py docs/djblets/conf.py djblets/cache/forwarding_backend.py djblets/cache/serials.py djblets/cache/backend_compat.py djblets/cache/backend.py Ignored Files: docs/djblets/coderef/index.rst
- Change Summary:
-
- Reworded a confusing section.
- Changed a type from
str
tounicode
.
- Commit:
-
ac4f0f8b9d1368bded3bf2f0cfccfa4f27fab788e6b0b2a7e1cf0c1959fdadbe8da8e6c7f860bad6
-
Tool: Pyflakes Processed Files: djblets/cache/context_processors.py docs/djblets/_ext/djangorefs.py docs/djblets/conf.py djblets/cache/forwarding_backend.py djblets/cache/serials.py djblets/cache/backend_compat.py djblets/cache/backend.py Ignored Files: docs/djblets/coderef/index.rst Tool: PEP8 Style Checker Processed Files: djblets/cache/context_processors.py docs/djblets/_ext/djangorefs.py docs/djblets/conf.py djblets/cache/forwarding_backend.py djblets/cache/serials.py djblets/cache/backend_compat.py djblets/cache/backend.py Ignored Files: docs/djblets/coderef/index.rst