Unnamed repository; edit this file 'description' to name the repository. https://git.platform-os.org/openstack/kolla.git/atom?h=master 2015-09-03T05:37:36+00:00 2015-09-03T05:37:36+00:00 Steven Dake stdake@cisco.com 2015-09-03T05:33:01+00:00 urn:sha1:233864ff32af10a2c927cdbca3475b537c8e6808 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 2015-08-28T12:25:11+00:00 Jenkins jenkins@review.openstack.org 2015-08-28T12:25:11+00:00 urn:sha1:3b5380ade021c9884551f427441cbfc0122eb0f0 2015-08-28T06:11:08+00:00 Kai Qiang Wu(Kennan) wkq5325@gmail.com 2015-08-28T01:38:42+00:00 urn:sha1:eae8903ae0748f6ca673b6dd941f7996fd51dc5f Partially-Implements: blueprint kolla-tox-doc Change-Id: Ie950667a61d9ce45fcc7e26915a7aa0f0ca6b597 2015-08-27T19:35:11+00:00 Major Hayden major@mhtx.net 2015-08-27T19:34:53+00:00 urn:sha1:ea39f9dfbfc19d3eb3e66035a2596438cdd4e234 Change-Id: Icc29fadc80030e4ff30fed8270629b21f6be6087 2015-08-25T00:10:42+00:00 Kai Qiang Wu(Kennan) wkq5325@gmail.com 2015-08-24T10:00:25+00:00 urn:sha1:2864b46957e7fbe830dc8d56a5f3915cc5aa8a2b Change-Id: Ib1e1ef16f62f3826e913bf865ad6f6e043673508 Closes-Bug: #1488014 2015-08-24T16:44:22+00:00 venkatamahesh venkatamaheshkotha@gmail.com 2015-08-24T16:44:22+00:00 urn:sha1:11d78626b5a3d2aa45d7788e8b3086493a77cb27 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 2015-08-21T22:17:01+00:00 Steven Dake stdake@cisco.com 2015-08-21T09:05:23+00:00 urn:sha1:2806e453b6f00797d673ac031de6cf5a05fe773e 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 2015-08-21T09:10:31+00:00 Steven Dake stdake@cisco.com 2015-08-21T06:06:10+00:00 urn:sha1:6e3127d0432a25124b3068e03d6e05fac8a73e63 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 2015-08-21T09:10:31+00:00 Steven Dake stdake@cisco.com 2015-08-21T06:00:55+00:00 urn:sha1:bbcf22cc1298dd0ad4f0826c9e1186298c64569e 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