Skip to content
Snippets Groups Projects
  1. Aug 21, 2015
    • Steven Dake's avatar
      Run pandoc to convert the documentation · 6e3127d0
      Steven Dake authored
      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
      6e3127d0
    • Steven Dake's avatar
      Prepare for MD to RST conversion · bbcf22cc
      Steven Dake authored
      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
      bbcf22cc
  2. Aug 20, 2015
  3. Aug 19, 2015
Loading