openstack/zaqar
Code Issues Proposed changes

Use doc8 check

Browse Source 
doc8 is a linter for documents and used in openstack-manuals. It is better to
enforce document linters for simple checking.

The current rules are really simple like:
- line length check (80 chars)
- new line at the end of file
- Trailing whitespace

Change-Id: I328e2b2b82739696b95eca4a4130ca347893b0dc
This commit is contained in:
liuyamin 2017-08-09 18:43:33 +08:00
parent 900bdbe3d9
commit 49a397ebfb
14 changed files with 84 additions and 63 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
doc/source/admin/OSprofiler.rst
View File

@ -41,7 +41,8 @@ performance, so please set to disable in production environment.
**connection_string**
Connection string for a notifier backend. Default value is messaging:// which
sets the notifier to oslo_messaging. Here we set it to "mongodb://localhost:27017"
sets the notifier to oslo_messaging. Here we set it to
"mongodb://localhost:27017"
**hmac_keys**

3
doc/source/contributor/development.environment.rst
View File

@ -78,7 +78,8 @@ On Ubuntu, follow the instructions in the
.. _`MongoDB on Ubuntu installation guide`: http://docs.mongodb.org/manual/tutorial/install-mongodb-on-ubuntu/
On Fedora-based distributions, follow the instructions in the
`MongoDB on Red Hat Enterprise, CentOS, Fedora, or Amazon Linux Installation Guide`_.
`MongoDB on Red Hat Enterprise, CentOS, Fedora, or Amazon Linux
Installation Guide`_.
.. _`MongoDB on Red Hat Enterprise, CentOS, Fedora, or Amazon Linux installation guide`: http://docs.mongodb.org/manual/tutorial/install-mongodb-on-red-hat-centos-or-fedora-linux/

31
doc/source/contributor/project_info.rst
View File

@ -23,15 +23,15 @@ Project Team Lead (PTL)
~~~~~~~~~~~~~~~~~~~~~~~
+------------------------------+------------------------------------------------+
+------------------------------+---------------------------------------------+
| Contact | Area of interest |
+------------------------------+------------------------------------------------+
+------------------------------+---------------------------------------------+
| | Feilong Wang | * Chief Architect |
| | flwang (irc) | * Release management |
| | flwang@catalyst.net.nz | * Community management |
| | flwang@qq.com | * Core team management |
| | | * Road Map |
+------------------------------+------------------------------------------------+
+------------------------------+---------------------------------------------+
| *If you would like to refactor whole Zaqar or have UX/community/other
issues please contact me.*
@ -40,24 +40,25 @@ Project Team Lead (PTL)
Project Core maintainers
~~~~~~~~~~~~~~~~~~~~~~~~
+------------------------------+------------------------------------------------+
+------------------------------+---------------------------------------------+
| Contact | Area of interest |
+------------------------------+------------------------------------------------+
+------------------------------+---------------------------------------------+
| | Xiyuan Wang | * Zaqar related questions or bugs. |
| | wxy (irc) UTC0200-UTC1000 | * Production problem for Zaqar. |
| | wangxiyuan1007@gmail.com | * Integration with container. |
| | | |
+------------------------------+------------------------------------------------+
| | Hao Wang | * Introduce interesting and helpful features |
+------------------------------+---------------------------------------------+
| | Hao Wang | * Introduce interesting and helpful |
| | | features |
| | wanghao (irc) | * Bug Fix and Code Optimization |
| | sxmatch1986@gmail.com | * Notification Service |
| | | |
+------------------------------+------------------------------------------------+
+------------------------------+---------------------------------------------+
| | Thomas Herve | * Websocket |
| | therve (irc) | * Swift backend |
| | therve@redhat.com | |
| | | |
+------------------------------+------------------------------------------------+
+------------------------------+---------------------------------------------+
| *All cores from this list are reviewing all changes that are proposed to Zaqar.
To avoid duplication of efforts, please contact them before starting work on
@ -67,28 +68,28 @@ Project Core maintainers
Storage Backend Maintainers reviewers
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+------------------------------+------------------------------------------------+
+------------------------------+---------------------------------------------+
| Contact | Area of interest |
+------------------------------+------------------------------------------------+
+------------------------------+---------------------------------------------+
| | Hao Wang | * MongoDB |
| | wanghao (irc) | |
| | sxmatch1986@gmail.com | |
+------------------------------+------------------------------------------------+
+------------------------------+---------------------------------------------+
| | gecong | * Swift |
| | gecong (irc) | |
| | ge.cong@zte.com.cn | |
| | | |
+------------------------------+------------------------------------------------+
+------------------------------+---------------------------------------------+
| | gengchc2 | * Redis |
| | gengchc (irc) | |
| | geng.changcai2@zte.com.cn | |
| | | |
+------------------------------+------------------------------------------------+
+------------------------------+---------------------------------------------+
| | Feilong Wang | * SqlAlchemy |
| | flwang (irc) | |
| | flwang@catalyst.net.nz | |
| | | |
+------------------------------+------------------------------------------------+
+------------------------------+---------------------------------------------+
| *All cores from this list are responsible for maintaining the storage backend.
To avoid duplication of efforts, please contact them before starting working

3
doc/source/glossary.rst
View File

@ -19,7 +19,8 @@ Messaging Service Concepts
==========================
The Messaging Service is a multi-tenant, message queue implementation that
utilizes a RESTful HTTP interface to provide an asynchronous communications
protocol, which is one of the main requirements in today’s scalable applications.
protocol, which is one of the main requirements in today’s scalable
applications.
.. glossary::

6
doc/source/install/index.rst
View File

@ -25,7 +25,8 @@ Installation Guide.
Ocata
~~~~~
To install Glance, see the Ocata Image service install guide for each distribution:
To install Glance, see the Ocata Image service install guide for each
distribution:
- `Ubuntu <https://docs.openstack.org/project-install-guide/messaging/ocata/install-ubuntu.html>`__
- `CentOS and RHEL <https://docs.openstack.org/project-install-guide/messaging/ocata/install-rdo.html>`__
@ -34,7 +35,8 @@ To install Glance, see the Ocata Image service install guide for each distributi
Newton
~~~~~~
To install Glance, see the Newton Image service install guide for each distribution:
To install Glance, see the Newton Image service install guide for each
distribution:
- `Ubuntu <https://docs.openstack.org/project-install-guide/messaging/newton/install-ubuntu.html>`__
- `CentOS and RHEL <https://docs.openstack.org/project-install-guide/messaging/newton/install-rdo.html>`__

1
test-requirements.txt
View File

@ -17,6 +17,7 @@ PyMySQL>=0.7.6 # MIT License
# Unit testing
coverage!=4.4,>=4.0 # Apache-2.0
ddt>=1.0.1 # MIT
doc8 # Apache-2.0
fixtures>=3.0.0 # Apache-2.0/BSD
python-subunit>=0.0.18 # Apache-2.0/BSD
testscenarios>=0.4 # Apache-2.0/BSD

16
tox.ini
View File

@ -45,6 +45,7 @@ commands = {posargs}
[testenv:docs]
commands =
doc8 doc/source
python setup.py build_sphinx
sphinx-build -W -b html api-ref/source api-ref/build/html
@ -62,7 +63,9 @@ commands =
commands = oslo_debug_helper {posargs}
[testenv:releasenotes]
commands = sphinx-build -a -E -d releasenotes/build/doctrees -b html releasenotes/source releasenotes/build/html
commands =
doc8 releasenotes/source releasenotes/notes
sphinx-build -a -E -d releasenotes/build/doctrees -b html releasenotes/source releasenotes/build/html
[flake8]
exclude = .venv*,.git,.tox,dist,doc,*lib/python*,*.egg,.update-venv
@ -72,5 +75,16 @@ max-complexity = 16
# [H904] Delay string interpolations at logging calls.
enable-extensions=H904
[doc8]
# File extensions to check
extensions = .rst, .yaml
# Maximal line length should be 80 but we have some overlong lines.
# Let's not get far more in.
max-line-length = 80
# Disable some doc8 checks:
# D000: Check RST validity
# - cannot handle "none" for code-block directive
ignore = D000
[hacking]
local-check-factory = zaqar.hacking.checks.factory