| Age | Commit message (Collapse) | Author | Files | Lines |
|---|
|
The publishing docs expect the documentation to be present in the
/doc directory not the /docs directory. If the documentation is in
the /docs directory, according to fungi the docs won't be published
properly.
Change-Id: I718fec7e69d298a5cb2376ca4e2455e12169566e
Partially-Implements: blueprint kola-tox-doc
|
|
|
|
Partially-Implements: blueprint kolla-tox-doc
Change-Id: Ie950667a61d9ce45fcc7e26915a7aa0f0ca6b597
|
|
Change-Id: Icc29fadc80030e4ff30fed8270629b21f6be6087
|
|
Change-Id: Ib1e1ef16f62f3826e913bf865ad6f6e043673508
Closes-Bug: #1488014
|
|
For two links extension is wrong, it is changed
For other one the path is wrong, it is updated
Change-Id: Idc2c7054f5bd0c47ff30de79585cf902082da448
Closes-Bug: #1488025
|
|
Individuals are beginning to evaluate Kolla and our quickstart
documentation is in terrible terrible shape. Pleae just approve
this change but do leave feedback. I will address changes in
an iterative process in future patches rather then having a
perfect documentation patch in one bang.
Since this isn't code, there is not a high cost to refactoring
or risk of regressions.
Change-Id: I222cf15f4c5d748fb2daf3638094b4e7b35f8844
|
|
This converts all MD formatted docs that were renamed to RST to
preserve git history into actual RST documentation. Some minor
edits were made but in general the purpose of this patch is to
*only* convert the documentation not rework the documentation.
I do plan on reworking the documentation in further patch sets.
All links were tested and a test rendering is available:
http://github.com/sdake/kolla
Change-Id: I3df430b14df1ede15407c7f4ba7afcbdc6f9d757
|
|
Sphinx and OpenStack documentation standards require the use of
RST formatted documentation. In order to get out docs integrated
into docs.openstack.org, the following steps must be taken:
1. we need to first convert the documentation to RST
2. sphinx support must be added to the repository
3. project-config must be updated with a publish-docs job
The ability to pubish to docs.openstack.org is a privilege only
available to Big Tent projects. As a result, we should be taking
advantage of this to help spread the word on our implementation.
Note the documentation was converted with a tool called pandoc
the syntax of which was:
pandoc -f markdown -t rst file.md > z
mv z file.rst
In order for git to preserve history the files have to be git mv'ed
in one commit followed by the pandoc operation in a separate commit.
Change-Id: Iba2a70b989e8305da03e8204a9b130d457b00cf0
|
