0bb20e83b8
A number of tools and scripts in openstack-doc-tools have been removed. Remove the documentation for these too. Change-Id: I11917e603ccb7d30c7d44d17b8c5eccbe574b35c Signed-off-by: Stephen Finucane <sfinucan@redhat.com>
61 lines
1.8 KiB
ReStructuredText
61 lines
1.8 KiB
ReStructuredText
================
|
|
Scripts overview
|
|
================
|
|
|
|
This section provides an overview of scripts used by the OpenStack
|
|
documentation project grouped by repositories they are stored in.
|
|
|
|
|
|
openstack-doc-tools repository
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
sitemap
|
|
Generates the ``sitemap.xml`` file.
|
|
|
|
bin
|
|
Contains scripts for building documents in the ``openstack-manuals``
|
|
repository. Used inside the tox environments.
|
|
|
|
os_doc_tools directory
|
|
----------------------
|
|
|
|
openstack-jsoncheck
|
|
Checks JSON files. Used for the API guides.
|
|
|
|
|
|
openstack-manuals repository
|
|
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
|
|
Several scripts currently reside in the `openstack-manuals
|
|
<https://github.com/openstack/openstack-manuals>`_ repository. It may be
|
|
beneficial to consolidate these into the ``openstack-doc-tools`` repository.
|
|
|
|
www-generator.py
|
|
Generates static, template-based HTML files for
|
|
https://docs.openstack.org/. See :doc:`template-generator` for details.
|
|
|
|
sync-projects.sh
|
|
Synchronizes the **Glossary**, common files, and some translations
|
|
across multiple repositories, including ``api-site`` and ``security-doc``.
|
|
|
|
publishdocs.sh
|
|
Publishdocs job uses this script to publish documentation to
|
|
https://docs.openstack.org/.
|
|
|
|
|
|
Notes
|
|
~~~~~
|
|
|
|
- ``openstack-doc-tools`` must be released so it can be pinned in requirements
|
|
files, enabling automation to work across repositories.
|
|
|
|
- There are many undocumented synchronizations (automated and manual) between
|
|
the various documentation repositories. These should be documented.
|
|
|
|
- There are a several jobs that must be run regularly, for example, updating
|
|
the ``sitemap.xml`` file and the command line configuration reference. These
|
|
should be documented.
|
|
|
|
- Some manual jobs should be automated. For example, the ``sitemap.xml`` file
|
|
should be automatically updated by the Gerritbot.
|