diff --git a/doc/contributor-guide/setup.cfg b/doc/contributor-guide/setup.cfg
index f43141762d..c2856bd72c 100644
--- a/doc/contributor-guide/setup.cfg
+++ b/doc/contributor-guide/setup.cfg
@@ -3,7 +3,7 @@ name = openstackdocumentationcontributorguide
summary = OpenStack Documentation Contributor Guide
author = OpenStack
author-email = openstack-docs@lists.openstack.org
-home-page = http://docs.openstack.org/
+home-page = https://docs.openstack.org/
classifier =
Environment :: OpenStack
Intended Audience :: Information Technology
diff --git a/doc/contributor-guide/source/blueprints-and-specs.rst b/doc/contributor-guide/source/blueprints-and-specs.rst
index 7674306bd0..2172f3976f 100644
--- a/doc/contributor-guide/source/blueprints-and-specs.rst
+++ b/doc/contributor-guide/source/blueprints-and-specs.rst
@@ -44,7 +44,7 @@ Release-specific documentation
The Installation Tutorials and Guides, Configuration Reference, and Networking
Guide are released at release time, with draft material published to
-http://docs.openstack.org/draft/draft-index.html.
+https://docs.openstack.org/draft/draft-index.html.
The rest of the guides are continuously released.
To patch for the release-specific documentation, you should generally patch to
@@ -78,33 +78,33 @@ process for multiple distributions based on the following packaging systems:
* - Installation Tutorial for openSUSE and SUSE Linux Enterprise Server
- http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/install-guide
- - http://docs.openstack.org/newton/install-guide-obs/
+ - https://docs.openstack.org/newton/install-guide-obs/
* - Installation Tutorial for Red Hat Enterprise Linux and CentOS
- http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/install-guide
- - http://docs.openstack.org/newton/install-guide-rdo/
+ - https://docs.openstack.org/newton/install-guide-rdo/
* - Installation Tutorial for Ubuntu 16.04 (LTS)
- http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/install-guide
- - http://docs.openstack.org/newton/install-guide-ubuntu/
+ - https://docs.openstack.org/newton/install-guide-ubuntu/
* - Installation Tutorial For Debian With Debconf
- http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/install-guide
- - http://docs.openstack.org/newton/install-guide-debconf/
+ - https://docs.openstack.org/newton/install-guide-debconf/
* - Installation Tutorial For Debian
- http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/install-guide
- - http://docs.openstack.org/newton/install-guide-debian/
+ - https://docs.openstack.org/newton/install-guide-debian/
Guides for deployers and administrators
---------------------------------------
* `OpenStack Configuration Reference
- `_:
+ `_:
Contains a reference listing of all configuration options for OpenStack
services by release version.
* `OpenStack Networking Guide
- `_:
+ `_:
This guide targets OpenStack administrators seeking to deploy and manage
OpenStack Networking (neutron).
@@ -117,11 +117,11 @@ Guides for deployers and administrators
* - Configuration Reference
- http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/config-reference
- - http://docs.openstack.org/newton/config-reference/
+ - https://docs.openstack.org/newton/config-reference/
* - OpenStack Networking Guide
- http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/networking-guide
- - http://docs.openstack.org/newton/networking-guide/
+ - https://docs.openstack.org/newton/networking-guide/
Continuously released documentation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -139,20 +139,20 @@ Guides for deployers and administrators
---------------------------------------
* `OpenStack Architecture Design Guide
- `_:
+ `_:
Contains information on how to plan, design and architect
an OpenStack cloud.
-* `OpenStack Administrator Guide `_:
+* `OpenStack Administrator Guide `_:
Contains how-to information for managing an OpenStack cloud as needed for
your use cases, such as storage, computing, or software-defined-networking.
-* `OpenStack High Availability Guide `_:
+* `OpenStack High Availability Guide `_:
Describes potential strategies for making your OpenStack services and
related controllers and data stores highly available.
-* `OpenStack Security Guide `_:
+* `OpenStack Security Guide `_:
Provide best practices and conceptual
information about securing an OpenStack cloud.
* `OpenStack Virtual Machine Image Guide
- `_:
+ `_:
Shows you how to obtain, create, and modify virtual machine images that
are compatible with OpenStack.
@@ -165,28 +165,28 @@ Guides for deployers and administrators
* - OpenStack Architecture Design Guide
- http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/arch-design
- - http://docs.openstack.org/arch-design/
+ - https://docs.openstack.org/arch-design/
* - OpenStack Administrator Guide
- http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/admin-guide
- - http://docs.openstack.org/admin-guide/
+ - https://docs.openstack.org/admin-guide/
* - OpenStack High Availability Guide
- http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/ha-guide
- - http://docs.openstack.org/ha-guide/
+ - https://docs.openstack.org/ha-guide/
* - OpenStack Security Guide
- http://git.openstack.org/cgit/openstack/security-doc/tree/security-guide
- - http://docs.openstack.org/security-guide/
+ - https://docs.openstack.org/security-guide/
* - OpenStack Virtual Machine Image Guide
- http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/image-guide
- - http://docs.openstack.org/image-guide/
+ - https://docs.openstack.org/image-guide/
Guides for end users
--------------------
-* `OpenStack End User Guide `_:
+* `OpenStack End User Guide `_:
Shows OpenStack end users how to create and manage resources in an
OpenStack cloud with the OpenStack dashboard and OpenStack client commands.
* `OpenStack API Guide
@@ -194,7 +194,7 @@ Guides for end users
A brief overview of how to send REST API requests to endpoints for
OpenStack services.
* `OpenStack Command-Line Interface Reference
- `_:
+ `_:
Automatically generates help text for CLI commands and subcommands.
.. list-table::
@@ -206,7 +206,7 @@ Guides for end users
* - OpenStack End User Guide
- http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/user-guide
- - http://docs.openstack.org/user-guide/
+ - https://docs.openstack.org/user-guide/
* - OpenStack API Guide
- http://git.openstack.org/cgit/openstack/api-site/tree/api-quick-start
@@ -214,7 +214,7 @@ Guides for end users
* - OpenStack Command-Line Interface Reference
- http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/cli-reference
- - http://docs.openstack.org/cli-reference/
+ - https://docs.openstack.org/cli-reference/
API documentation
-----------------
@@ -226,7 +226,7 @@ API documentation
Within project's specification repos, some have opted
to document API specifications, such as Identity.
* `Object Storage API v1
- `_
+ `_
We are migrating away from WADL in 2016. Refer to :ref:`api-docs` for details.
Once the migration is complete, the API reference pages will be stored in the
@@ -237,21 +237,21 @@ Project-specific guides
Each project maintains its own developer guide.
They are published from each project repository.
-See http://docs.openstack.org/developer/openstack-projects.html
-and http://docs.openstack.org/developer/language-bindings.html.
+See https://docs.openstack.org/developer/openstack-projects.html
+and https://docs.openstack.org/developer/language-bindings.html.
Contributor guides
------------------
-Generally, the http://docs.openstack.org/developer/ documentation is meant
+Generally, the https://docs.openstack.org/developer/ documentation is meant
for contributors to OpenStack projects. Each project's repo has a
``doc/source`` directory where RST source files are stored. They are built
automatically with Sphinx when the patch is merged. For example, see
http://git.openstack.org/cgit/openstack/horizon/tree/doc/source for the
-horizon contributor documentation source and http://docs.openstack.org/developer/horizon/
+horizon contributor documentation source and https://docs.openstack.org/developer/horizon/
for the built documentation.
-* `Infrastructure User Manual `_:
+* `Infrastructure User Manual `_:
Reference documentation for tools and processes used for all
contributors to OpenStack projects. It includes instructions on how
to create all the necessary accounts, setup development environment,
@@ -268,25 +268,25 @@ for the built documentation.
* - Documentation Contributor Guide
- http://git.openstack.org/cgit/openstack/openstack-manuals/tree/doc/contributor-guide
- - http://docs.openstack.org/contributor-guide/
+ - https://docs.openstack.org/contributor-guide/
* - Python Developer Documentation
- http://git.openstack.org/cgit/openstack//tree/master/doc/source/,
such as http://git.openstack.org/cgit/openstack/nova/tree/doc/source
- - http://docs.openstack.org/developer/openstack-projects.html
+ - https://docs.openstack.org/developer/openstack-projects.html
* - Language Bindings and Python Clients
- http://git.openstack.org/cgit/openstack/python-client/tree/master/doc/source/,
such as http://git.openstack.org/cgit/openstack/python-novaclient/tree/doc/source
- - http://docs.openstack.org/developer/language-bindings.html
+ - https://docs.openstack.org/developer/language-bindings.html
* - OpenStack Project Infrastructure
- http://git.openstack.org/cgit/openstack-infra/system-config/tree/doc/source
- - http://docs.openstack.org/infra/system-config/
+ - https://docs.openstack.org/infra/system-config/
* - Tempest Testing Project
- http://git.openstack.org/cgit/openstack/tempest/tree/doc/source
- - http://docs.openstack.org/developer/tempest/
+ - https://docs.openstack.org/developer/tempest/
Guides for contributors
-----------------------
diff --git a/doc/contributor-guide/source/doc-tools/contributing.rst b/doc/contributor-guide/source/doc-tools/contributing.rst
index 192727a111..2a3cdd9852 100644
--- a/doc/contributor-guide/source/doc-tools/contributing.rst
+++ b/doc/contributor-guide/source/doc-tools/contributing.rst
@@ -12,9 +12,9 @@ To contribute to the development of ``openstack-doc-tools``, proceed with
the following steps:
#. Complete the procedures described
- in the `Developers Guide `_.
+ in the `Developers Guide `_.
-#. Follow `OpenStack Style Commandments `_
+#. Follow `OpenStack Style Commandments `_
while developing improvements for the tool.
#. Run tests before you submit your change request.
@@ -23,7 +23,7 @@ the following steps:
and ``bashate`` tests. A test suite would be welcome.
#. Submit your change for review through the Gerrit tool as described
- in the `gerrit workflow `_.
+ in the `gerrit workflow `_.
.. warning::
diff --git a/doc/contributor-guide/source/doc-tools/scripts.rst b/doc/contributor-guide/source/doc-tools/scripts.rst
index cb44bdb683..c1afd6817d 100644
--- a/doc/contributor-guide/source/doc-tools/scripts.rst
+++ b/doc/contributor-guide/source/doc-tools/scripts.rst
@@ -11,7 +11,7 @@ openstack-doc-tools repository
autogenerate_config_docs
Generates configuration references published at
- http://docs.openstack.org/newton/config-reference/.
+ https://docs.openstack.org/newton/config-reference/.
build_environment directory (deprecated)
A Vagrant environment for working with the guides.
@@ -34,7 +34,7 @@ openstack-autohelp
openstack-auto-commands
Generates the command-line interface reference published at
- http://docs.openstack.org/cli-reference/. A helper script to use this
+ https://docs.openstack.org/cli-reference/. A helper script to use this
tool is available at ``bin/doc-tools-update-cli-reference``.
openstack-jsoncheck
@@ -49,7 +49,7 @@ Several scripts currently reside in the `openstack-manuals
beneficial to consolidate these into the ``openstack-doc-tools`` repository.
www-generator.py
- Generates static, template-based HTML files for http://docs.openstack.org/.
+ Generates static, template-based HTML files for https://docs.openstack.org/.
sync-projects.sh
Synchronizes the **Glossary**, common files, and some translations
@@ -57,7 +57,7 @@ sync-projects.sh
publishdocs.sh
Publishdocs job uses this script to publish documentation to
- http://docs.openstack.org/.
+ https://docs.openstack.org/.
Notes
diff --git a/doc/contributor-guide/source/docs-builds.rst b/doc/contributor-guide/source/docs-builds.rst
index fd8ca3a65e..195bfda3a9 100644
--- a/doc/contributor-guide/source/docs-builds.rst
+++ b/doc/contributor-guide/source/docs-builds.rst
@@ -110,7 +110,7 @@ To get the ``.html`` output locally, switch to the directory containing a
The RST source is built into HTML using Sphinx, so that it is displayed on
the *docs.openstack.org/*. For example:
-http://docs.openstack.org/user-guide/.
+https://docs.openstack.org/user-guide/.
Using Tox to check builds
-------------------------
diff --git a/doc/contributor-guide/source/docs-review.rst b/doc/contributor-guide/source/docs-review.rst
index 83c6bb5909..95dc5516c0 100644
--- a/doc/contributor-guide/source/docs-review.rst
+++ b/doc/contributor-guide/source/docs-review.rst
@@ -16,7 +16,7 @@ review, use the `Documentation Program Dashboard
audience for the documentation. To see current proposed changes, make sure
you register and log into https://review.openstack.org. For more details on
the review process, see `Code Review
-`_.
+`_.
Repositories and core team
~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -44,7 +44,7 @@ Reviewing a documentation patch
Before you proceed with reviewing patches, make sure to read carefully
the :doc:`Review Guidelines ` for documentation
and `Code Review Guidelines
-`_.
+`_.
Once done, follow the steps below to submit a patch review.
#. Go to the `Documentation Program Dashboard
@@ -70,12 +70,12 @@ Once done, follow the steps below to submit a patch review.
A patch with WorkInProgress (WIP) status needs additional work
before review and possible approval. Therefore, you may skip such a patch
and review once it is ready. For more information, see `Work In Progress
- `_.
+ `_.
.. seealso::
`Peer Review
- `_
+ `_
Achieving core reviewer status
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -124,7 +124,7 @@ unfavorable gets through, without discouraging contributions.
General instructions for being a core reviewer are located in the
`Core Reviewer's Guide
-`_.
+`_.
This section is for openstack-manuals core reviewers.
In almost all cases, patches can be merged with at least one +1 vote, and
diff --git a/doc/contributor-guide/source/project-deploy-guide.rst b/doc/contributor-guide/source/project-deploy-guide.rst
index 6cd7134193..ff53585acd 100644
--- a/doc/contributor-guide/source/project-deploy-guide.rst
+++ b/doc/contributor-guide/source/project-deploy-guide.rst
@@ -6,7 +6,7 @@ As of the Newton release, a new method of publishing deployment guides has
been implemented. This allows each deployment projects to create their own
deployment guide, based on a standard template, in their own repository.
These guides are then centrally published to
-`Deployment Guides `_.
+`Deployment Guides `_.
Setting up
~~~~~~~~~~
diff --git a/doc/contributor-guide/source/project-install-guide.rst b/doc/contributor-guide/source/project-install-guide.rst
index bd402575ac..52456104c8 100644
--- a/doc/contributor-guide/source/project-install-guide.rst
+++ b/doc/contributor-guide/source/project-install-guide.rst
@@ -6,7 +6,7 @@ For the Newton release, a new method of publishing installation tutorials
and guides is being implemented. This will allow each big tent project to
create their own installation guide, based on a standard template,
in their own repository. These guides are then centrally published to
-`docs.openstack.org `_.
+`docs.openstack.org `_.
For updates on the progress of this project, see the `Install Guide wiki
page `_.
diff --git a/doc/contributor-guide/source/quickstart/first-timers.rst b/doc/contributor-guide/source/quickstart/first-timers.rst
index 68658b92ab..a86881d3c2 100644
--- a/doc/contributor-guide/source/quickstart/first-timers.rst
+++ b/doc/contributor-guide/source/quickstart/first-timers.rst
@@ -294,7 +294,7 @@ Try again when your network connection improves.
If you suspect that SSH over non-standards ports might be blocked or need to
access the web using http/https, you can configure git-review to `use an http
-endpoint instead of ssh `_
+endpoint instead of ssh `_
as explained in the Infrastructure Manual.
Python
@@ -335,12 +335,12 @@ instead:
.. Links
-.. _`Account Setup`: http://docs.openstack.org/infra/manual/developers.html#account-setup
-.. _`Sign the appropriate Individual Contributor License Agreement`: http://docs.openstack.org/infra/manual/developers.html#sign-the-appropriate-individual-contributor-license-agreement
-.. _`Installing git-review`: http://docs.openstack.org/infra/manual/developers.html#installing-git-review
+.. _`Account Setup`: https://docs.openstack.org/infra/manual/developers.html#account-setup
+.. _`Sign the appropriate Individual Contributor License Agreement`: https://docs.openstack.org/infra/manual/developers.html#sign-the-appropriate-individual-contributor-license-agreement
+.. _`Installing git-review`: https://docs.openstack.org/infra/manual/developers.html#installing-git-review
.. _`OpenStack Documentation Bug Team`: https://launchpad.net/~openstack-doc-bugs
.. _`OpenStack Foundation`: http://www.openstack.org/join
-.. _`Development Workflow`: http://docs.openstack.org/infra/manual/developers.html#development-workflow
+.. _`Development Workflow`: https://docs.openstack.org/infra/manual/developers.html#development-workflow
.. _`git`: http://msysgit.github.io
.. _`curl`: http://curl.haxx.se/
.. _`tar`: http://gnuwin32.sourceforge.net/packages/gtar.htm
@@ -350,8 +350,8 @@ instead:
.. _`GitHub help`: https://help.github.com/articles/set-up-git
.. _`Settings page on gerrit`: https://review.openstack.org/#/settings/
.. _`Settings > SSH Public Keys`: https://review.openstack.org/#/settings/ssh-keys
-.. _`Starting Work on a New Project`: http://docs.openstack.org/infra/manual/developers.html#starting-work-on-a-new-project
-.. _`Starting a Change`: http://docs.openstack.org/infra/manual/developers.html#starting-a-change
-.. _`Committing a change`: http://docs.openstack.org/infra/manual/developers.html#committing-a-change
-.. _`Submitting a Change for Review`: http://docs.openstack.org/infra/manual/developers.html#submitting-a-change-for-review
-.. _`Updating a Change`: http://docs.openstack.org/infra/manual/developers.html#updating-a-change
+.. _`Starting Work on a New Project`: https://docs.openstack.org/infra/manual/developers.html#starting-work-on-a-new-project
+.. _`Starting a Change`: https://docs.openstack.org/infra/manual/developers.html#starting-a-change
+.. _`Committing a change`: https://docs.openstack.org/infra/manual/developers.html#committing-a-change
+.. _`Submitting a Change for Review`: https://docs.openstack.org/infra/manual/developers.html#submitting-a-change-for-review
+.. _`Updating a Change`: https://docs.openstack.org/infra/manual/developers.html#updating-a-change
diff --git a/doc/contributor-guide/source/release/release-tools.rst b/doc/contributor-guide/source/release/release-tools.rst
index bafa5622d7..4e7f8389fc 100644
--- a/doc/contributor-guide/source/release/release-tools.rst
+++ b/doc/contributor-guide/source/release/release-tools.rst
@@ -9,4 +9,4 @@ The ``openstackdocstheme``, ``openstack-doc-tools``, and
The release is done by the OpenStack release team but needs to be
triggered by the documentation team. For details, see `Release
management
-`__.
+`__.
diff --git a/doc/contributor-guide/source/release/taskdetail.rst b/doc/contributor-guide/source/release/taskdetail.rst
index 3b9ceca23c..01f0131ec8 100644
--- a/doc/contributor-guide/source/release/taskdetail.rst
+++ b/doc/contributor-guide/source/release/taskdetail.rst
@@ -60,7 +60,7 @@ Speciality Team lead, listed at :doc:`../team-structure`., and ask them for
the notes for the books they look after. The source repository for release
notes is `openstack-manuals/releasenotes/source/RELEASENAME` and they are
published to
-``http://docs.openstack.org/releasenotes/openstack-manuals/RELEASENAME.html``.
+``https://docs.openstack.org/releasenotes/openstack-manuals/RELEASENAME.html``.
Publish index page
~~~~~~~~~~~~~~~~~~
@@ -163,7 +163,7 @@ for release-specific documentation:
as OpenStack Liberty has reached its official end-of-life.
This guide will not get any updates from the OpenStack project anymore.
See the `OpenStack Documentation page
- `_ for current documentation.
+ `_ for current documentation.
For continuously released documentation, exclude the release from target.
@@ -180,5 +180,5 @@ To:
This guide documents OpenStack Newton and Mitaka releases.
However, we will keep the documentation on the
-`docs.openstack.org `_
+`docs.openstack.org `_
page for a while so that the users can refer the guides if necessary.
diff --git a/doc/contributor-guide/source/rst-conv/references.rst b/doc/contributor-guide/source/rst-conv/references.rst
index 41167651c4..e240e2dd8c 100644
--- a/doc/contributor-guide/source/rst-conv/references.rst
+++ b/doc/contributor-guide/source/rst-conv/references.rst
@@ -56,14 +56,14 @@ To link to some external locations, format the RST source as follows:
.. code-block:: none
- Here is a link to the User guide: http://docs.openstack.org/user-guide/.
+ Here is a link to the User guide: https://docs.openstack.org/user-guide/.
Here is an external web link with a link title:
- `User guide `_.
+ `User guide `_.
**Output**
-Here is a link to the User guide: http://docs.openstack.org/user-guide/.
+Here is a link to the User guide: https://docs.openstack.org/user-guide/.
Here is an external web link with a link title:
-`User guide `_.
+`User guide `_.
diff --git a/doc/contributor-guide/source/ux-ui-guidelines/gui-guidelines.rst b/doc/contributor-guide/source/ux-ui-guidelines/gui-guidelines.rst
index 64770e7e02..d5c43a44bd 100644
--- a/doc/contributor-guide/source/ux-ui-guidelines/gui-guidelines.rst
+++ b/doc/contributor-guide/source/ux-ui-guidelines/gui-guidelines.rst
@@ -94,7 +94,7 @@ The following patterns provide GUI frameworks to assist designers and engineers
to create interfaces that are consistent across OpenStack products.
For example, the horizon project chooses to use ``bootstrap``.
-See `Styling in Horizon (SCSS) `_
+See `Styling in Horizon (SCSS) `_
for more information.
Cancel buttons
diff --git a/doc/contributor-guide/source/writing-style/general-writing-guidelines.rst b/doc/contributor-guide/source/writing-style/general-writing-guidelines.rst
index 66e3fbb226..94e19a7050 100644
--- a/doc/contributor-guide/source/writing-style/general-writing-guidelines.rst
+++ b/doc/contributor-guide/source/writing-style/general-writing-guidelines.rst
@@ -211,7 +211,7 @@ Each title should include a clear description of the page’s subject.
Also, ensure that you follow the documentation guidelines for titles.
For more information,
-see http://docs.openstack.org/contributor-guide/rst-conv/titles.html.
+see https://docs.openstack.org/contributor-guide/rst-conv/titles.html.
.. _be_clear_and_concise:
diff --git a/doc/contributor-guide/source/writing-style/release-names.rst b/doc/contributor-guide/source/writing-style/release-names.rst
index 3b45cde08b..f654ef2162 100644
--- a/doc/contributor-guide/source/writing-style/release-names.rst
+++ b/doc/contributor-guide/source/writing-style/release-names.rst
@@ -4,7 +4,7 @@ Release names
~~~~~~~~~~~~~
Use the names of the OpenStack releases as described on
-the `OpenStack Releases `_
+the `OpenStack Releases `_
page
**Example:**
diff --git a/doc/contributor-guide/source/writing-style/word-choice.rst b/doc/contributor-guide/source/writing-style/word-choice.rst
index 96e66f414f..f23cf371b6 100644
--- a/doc/contributor-guide/source/writing-style/word-choice.rst
+++ b/doc/contributor-guide/source/writing-style/word-choice.rst
@@ -6,7 +6,7 @@ Word choice
This section offers conventions around general English usage and the terms that
are not covered in the
-`glossary `_.
+`glossary `_.
Additionally, use the `IBM
Terminology `_ as
a reference.