On Feb 20, 2014, at 6:11 PM, Radhika Puthiyetath <radhika.puthiyet...@citrix.com> wrote:
> Hi, > > From Citrix-perspective, this is going to be effort intensive considering the > current head count for documentation. > > For 4.3, we would like to continue with DocBook, as per our earlier > consensus. > > I shall come back with a concrete plan soon after completing the 4.3 feature > documentation. > > Hope it works. Thanks for your patience. > > -Radhika Radhika, I went through all the commits on master and 4.3 branch and made sure I ported everything to RTD. We are good to go up to your latest commit on Feb 6th: 58ec1d0091f80845412b42543191acc1e976383b There are some issues with the content, I see a missing file. So I ported what I could and left some. So from my standpoint we can switch to RTD now for all docs (master and 4.3 content is all in). The RN are ready, the install guide is ready, most of the dev guide is ready and I should be done today. That leaves the admin guide to format but I will start today and should be done before 4.3 is voted. Bottom line all commits have been migrated to RTD and .rst format. -Sebastien > > -----Original Message----- > From: sebgoa [mailto:run...@gmail.com] > Sent: Thursday, February 20, 2014 8:50 PM > To: dev@cloudstack.apache.org; Radhika Puthiyetath > Cc: Animesh Chaturvedi; Hugo Trippaers; Dave Cahill; Yoshikazu Nojima > Subject: [DOCS][DISCUSS] heads-up main docs repo refactor > > Hi, > > With the change of format for docs, I have started to refactor the main docs > repo "cloudstack-docs.git" > > The allocator,midonet,nicira,qig,vxlan and release notes guides have been > converted to .rst format. > > I am moving the docbook version of these guides into an /archive directory > for the time being. > > I will move my github repo that is used to build > http://cloudstack.readthedocs.org/en/latest/ to the main docs repo. > > The release notes now have their main repo and are up to date for 4.3 release. > > Now for the [DISCUSS] part: > > * The install and admin guides also have their own repo so we could remove > them from cloudstack-docs with a temporary move to the /archive dir . > > *My thought is to keep the cloudstack-docs repo for a "catch all" docs where > people can contribute "guides" that stand on their own, while the admin and > install repos are for the complete guides that we need to improve as complete > end-to-end docs. > > * @Radhika you are mostly the only one writing in docbook, when do you feel > comfortable switching to .rst ? I am willing to help clean up the period when > we have a few left over docbook commits that need to be merged in .rst. But > we do need to have date at which point we make docbook "obsolete". I have > already started going through your last 10 commits to make sure the content > is in the new format. > > thoughts, > > -Sebastien
