Wow, just looked for the first time - that looks great :) Personally I usually hit cloudstack.org<http://cloudstack.org> and then look for links to docs. On the RTD sites, might wanna have links from install -> admin and vice-versa...
On Feb 18, 2014, at 5:12 AM, Sebastien Goasguen <run...@gmail.com<mailto:run...@gmail.com>> wrote: On Jan 27, 2014, at 11:25 AM, sebgoa <run...@gmail.com<mailto:run...@gmail.com>> wrote: Quick update on this thread. I made some initial commits to the two new docs repo: https://git-wip-us.apache.org/repos/asf?p=cloudstack-docs-admin.git;a=summary https://git-wip-us.apache.org/repos/asf?p=cloudstack-docs-install.git;a=summary These were made by: 1- using publican to build a html-single output of the current documentation. 2- using pandoc to convert the single html page to .rst 3- build a sphinx project for each repo using sphinx-quickstart 4- moved the .rst file to the skeleton sphinx project 5- fixed Note and Warning tags 6- fixed some issues with couple images not present or replication of reference This leads to two successful build, even though there are still warning and lots of work to do with the table of content. To test the result I created two Read The Docs projects, the results is on-line: http://cloudstack-administration.readthedocs.org/en/latest/ http://cloudstack-installation.readthedocs.org/en/latest/ This is clearly not finished and this will require more work to check the format, the conversion with pandoc may have broken some things. The end result so far is that I feel it is much easier to work with, just grab your favorite editor and you can actually read the docs, and fix it. I also right away deleted some chapters in the admin guide (concepts..) that were a copy of the install guide. I plan to do the same process for the release notes... -Sebastien On Jan 22, 2014, at 6:27 PM, Alex Hitchins <alex.hitch...@shapeblue.com> wrote: Personally, I think if possible; http://docs.cloudstack.apache.org could go to a page with both sets available, linking to http://admin.docs.cloudstack.apache.org http://install.docs.cloudstack.apache.org Any other thoughts ??? My thinking is docs.cloudstack.apache.org<http://docs.cloudstack.apache.org> is easier to remember. I wonder if there is a SEO benefit to either option. Be good it the install and admin guides we well crawled. Alex Hitchins +44 7788 423 969 -----Original Message----- From: sebgoa [mailto:run...@gmail.com] Sent: 22 January 2014 17:18 To: dev@cloudstack.apache.org<mailto:dev@cloudstack.apache.org> Subject: [DOCS][PROPOSAL] Move to .rst and new repos Hi, Prior to the break we had a discussion to move to a new doc format RST. In investigating the process and the infra needed for this, David and I thought that having a repo for each guide/book would be good. Otherwise the readthedocs build infra will create one massive pdf/epub, think ~400 pages. So David created couple repos: cloudstack-docs-admin.git cloudstack-docs-install.git Now we need to decide on CNAMEs for each guide, meaning that to get to the admin guide (for instance) you will hit http://admin.foo ... We propose to use: http://docs-admin.cloudstack.apache.org http://docs-install.cloudstack.apache.org thoughts ? better ideas ? -Sebastien Need Enterprise Grade Support for Apache CloudStack? Our CloudStack Infrastructure Support<http://shapeblue.com/cloudstack-infrastructure-support/> offers the best 24/7 SLA for CloudStack Environments. Apache CloudStack Bootcamp training courses **NEW!** CloudStack 4.2.1 training<http://shapeblue.com/cloudstack-training/> 18th-19th February 2014, Brazil. Classroom<http://shapeblue.com/cloudstack-training/> 17th-23rd March 2014, Region A. Instructor led, On-line<http://shapeblue.com/cloudstack-training/> 24th-28th March 2014, Region B. Instructor led, On-line<http://shapeblue.com/cloudstack-training/> 16th-20th June 2014, Region A. Instructor led, On-line<http://shapeblue.com/cloudstack-training/> 23rd-27th June 2014, Region B. Instructor led, On-line<http://shapeblue.com/cloudstack-training/> This email and any attachments to it may be confidential and are intended solely for the use of the individual to whom it is addressed. Any views or opinions expressed are solely those of the author and do not necessarily represent those of Shape Blue Ltd or related companies. If you are not the intended recipient of this email, you must neither take any action based upon its contents, nor copy or show it to anyone. Please contact the sender if you believe you have received this email in error. Shape Blue Ltd is a company incorporated in England & Wales. ShapeBlue Services India LLP is a company incorporated in India and is operated under license from Shape Blue Ltd. Shape Blue Brasil Consultoria Ltda is a company incorporated in Brasil and is operated under license from Shape Blue Ltd. ShapeBlue is a registered trademark. Stratosec<http://stratosec.co/> - Compliance as a Service o: 415.315.9385 @johnlkinsella<http://twitter.com/johnlkinsella>
