stevedore is a library that is used outside of OpenStack, too. Having
a build requirement that needs something OpenStack specific makes
life in cases (eg. for downstream packagers) more difficult.
So let's make openstackdocstheme an optional requirement.
Change-Id: Ic8cc577e617e5da699f9dc43830183005bd2ee66
We register two entry points in sample code, but show three items
in entry_points.txt, just remove it to keep consistent with code.
Change-Id: I7a76c4f23086fe1abdbf7140ba92f97ec1387aed
otherwise, when building from unchanged source in 2018,
it would claim Copyright 2018, Dreamhost
which is not true
Change-Id: I5185828a965467ea04033e46a1af2435df4ad760
Clarify that the python import path is scanned to find packages and
their metadata is examined, so that it is clear that the packages must
be installed in a way that makes them both visible to the same python
interpreter.
Change-Id: I0fc58b3ccc024e209d7f49de7402de67d4437295
One of the most common misconceptions about plugins is that they must be
installed to the same python package as the application. Update the
documentation to provide an explicit example of providing plugins from a
separate package.
Also clean up the package metadata for the existing example to remove
references to URLs and email addresses that no longer work.
Change-Id: I801b6ec3ff287c5342ce63a865167f55d31c78d3
Closes-Bug: #1394393
Replace the hand curated list of changes with the one generated by pbr
automatically.
At the same time, change the toctree settings in index.rst to avoid
showing every release of stevedore at the top level and to clean up the
amount of nesting showing for other entries.
Change-Id: I3fb9306c0ca3ce6ed9681ffeaa8b9b8ed0f2bd7c
occuring -> occurring
for patterns_loading.rst
Plus some source comment spelling fix.
Change-Id: Ia6c79588e70a4150fdcb8e71d14a4bba47a70a23
Signed-off-by: Zhao Lei <zhaolei@cn.fujitsu.com>
All the .jpg files in doc/source/essays had this embedded:
"Copyright 2007 Apple Inc., all rights reserved."
This is an ICC color profile which is copyrighted by Apple
and which is non-free, and may trigger some warnings/errors
by the distribution linters.
This patch converts the .jpg into the sRGB color space. I
did this simply loading the images in GIMP, and exporting
again after accepting the auto-coversion to sRGB.
Change-Id: Ibfdf0828ff149d5c83eb864c4fb854e80868a613
Add a restructuredtext directive for documenting a set of plugins with
the needed hooks to make it available is sphinx.
Change-Id: I1a24f9326b4e54174d9dc0ae366315fe29c3ac1b
We have CI for 2.6, 2.7, 3.4. So make sure
all references to other versions are removed and
all 3 versions above are correctly mentioned where
required.
Make sure we specify 3.4 everywhere needed
Change-Id: I2c90bccfc7495bf8197319196a12b2a8bd0519f1
Move the requirements definitions and documentation files to the
standard places used by other OpenStack projects so our doc publishing
jobs will work.
Change-Id: Iea630d827976fe517afacf4e373b3a125efff9c9