This commit updates the tox 'docs' environment to also run our specs
tests, so that the existing docs gate merge jobs will catch any specs
that get added but don't follow the template.
This commit also updates the specs test to suppress warnings for
:doc: references in specs.
Change-Id: Ie7dda124a0c964712b1a02b55730a76fa346111e
Closes-Bug: #1621648
Moved octavia/bin directory to octavia/octavia/cmd and renamed octavia-api to
api.py. This follows the new strucutre most openstack projects are doing.
Also implemented octavia-api being built when doing setup install.
Had to remove the octavia/tests/specs symlink because pbr did not like it and
would not allow anything to be built. Also found out the test_titles test was
not being run on the specs, so that has been added as a separate tox
environment.
Change-Id: I92f2bc6eaa346983f7a2479dc9fa43d2040f2cd5