openstack/openstack-manuals
Code Issues Proposed changes

Merge "Add guidelines on the use of example URLs"

Browse Source
This commit is contained in:
Jenkins 2017-01-22 05:36:14 +00:00 committed by Gerrit Code Review
commit 3dc6caccb5
2 changed files with 15 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

1
doc/contributor-guide/source/writing-style.rst
View File

@ -17,6 +17,7 @@ throughout all technical publications.
writing-style/punctuation.rst writing-style/punctuation.rst
writing-style/headings.rst writing-style/headings.rst
writing-style/lists.rst writing-style/lists.rst
writing-style/urls.rst
writing-style/num_and_units_of_measure.rst writing-style/num_and_units_of_measure.rst
writing-style/openstack-components.rst writing-style/openstack-components.rst
writing-style/release-names.rst writing-style/release-names.rst

14
doc/contributor-guide/source/writing-style/urls.rst Normal file
View File

@ -0,0 +1,14 @@
====
URLs
====
Use the following example URL as a guideline for the use of example URLs.
.. note::
Example.org is reserved by IANA for example URLs.
Use the convention `project_name`, then `openstack`, followed by `example.org`.
For example:
``http://glance.openstack.example.org/``