On Mar 20, 2014, at 8:00 AM, Pierre-Luc Dion <pd...@cloudops.com> wrote:
> Thanks Sebastien for the pull request. > I will submit a new one to fix a tables and internal reference links later > this week. no thank you. Make sure you pull before your next patch, I made more changes this morning. > > I haven't found how we should update internal links. Look like we would > have to change them for ex: `networking2.html#create vpn` > Anyone know another method to create link to topic from another file? > I have not looked on how to do this across files. But I think you should be able to do an implicite hyperlink target: http://docutils.sourceforge.net/docs/user/rst/quickref.html#internal-hyperlink-targets Since sphinx combines all files, it should find the section titles etc..nicely. > Also, > could we split networking2.rst file into multiple parts? > Have at it, feel free to edit the content (not just formatting). The whole idea of changing format and submission process is to make it easy to edit and improve the quality of the content. -sebastien > Thanks > > Le mardi 18 mars 2014, sebgoa <run...@gmail.com> a écrit : > >> >> On Mar 18, 2014, at 3:50 PM, Pierre-Luc Dion >> <pd...@cloudops.com<javascript:;>> >> wrote: >> >>> Thanks Sebastien, >>> >>> >>> Seams quite complete! Is there a reason why doc url on >>> http://cloudstack.apache.org/ still point to the old doc ? >> >> My plan is to make the switch once 4.3 is out. >> >> There is still some cleaning up to do on the .rst/RTD stuff which would be >> nice to fix before making it official. >> >> Also, we might have to vote on docs releases...haven't touched that one yet >> :) >> >> -sebastien >> >>> >>> >>> >>> Pierre-Luc Dion >>> Architecte de Solution Cloud | Cloud Solutions Architect >>> 514-447-3456, 1101 >>> - - - >>> >>> *CloudOps*420 rue Guy >>> Montréal QC H3J 1S6 >>> www.cloudops.com >>> @CloudOps_ >>> >>> >>> On Tue, Mar 18, 2014 at 10:16 AM, sebgoa <run...@gmail.com<javascript:;>> >> wrote: >>> >>>> >>>> On Mar 18, 2014, at 3:02 PM, Pierre-Luc Dion >>>> <pd...@cloudops.com<javascript:;>> >> wrote: >>>> >>>>> Thanks Wido, >>>>> >>>>> Cool, look like the rtd version is in there too. so I guest we need a >>>> lot >>>>> of work on conversion from publican to RST? >>>> >>>> It' already done :) I'd be mean I would tell you to search the mailing >>>> list :) >>>> >>>> If you search the cloudstack mirrors on github: >>>> https://github.com/orgs/apache?query=cloudstack >>>> >>>> you will see four documentation repo. >>>> cloudstack-docs >>>> cloudstack-docs-rn (release notes) >>>> cloudstack-docs-admin (the admin guide) >>>> cloudstack-docs-install (the installation guide) >>>> >>>> the rn, admin and installation guide are pure rest, and are a conversion >>>> of the publican to .rst. there is still work to do, especially on the >> admin >>>> guide. >>>> >>>> These docs are pushed automatically to readthedocs.org and provide: >>>> >>>> http://apache-cloudstack-release-notes.readthedocs.org/en/latest/ >>>> http://cloudstack-installation.readthedocs.org/en/latest/ >>>> http://cloudstack-administration.readthedocs.org/en/latest/ >>>> http://docs.cloudstack.apache.org >>>> >>>> I am actively working on cleaning this up and fixing the URLs/CNAMEs. >>>> >>>> The easiest way to contribute is *really* to visit the RTD sites and >> click >>>> on the "edit on github" button, this will automatically fork the repo in >>>> your github account. >>>> You can then submit a pull request. It will send a notification on >> dev@list and we can merge it. >>>> >>>> There is still lots of work to do, both on the formatting (the >> conversion >>>> was not perfect) and the content of course. >>>> >>>> Have at it, I'd be delighted to merge your patches :) >>>> >>>> -sebastien >>>> >>>>> >>>>> >>>>> >>>>> >>>>> Pierre-Luc Dion >>>>> Architecte de Solution Cloud | Cloud Solutions Architect >>>>> 514-447-3456, 1101 >>>>> - - - >>>>> >>>>> *CloudOps*420 rue Guy >>>>> Montréal QC H3J 1S6 >>>>> www.cloudops.com >>>>> @CloudOps_ >>>>> >>>>> >>>>> On Tue, Mar 18, 2014 at 9:15 AM, Wido den Hollander >>>>> <w...@widodh.nl<javascript:;> >>> >>>> wrote: >>>>> >>>>>> On 03/18/2014 02:08 PM, Pierre-Luc Dion wrote: >>>>>> >>>>>>> Hi all, >>>>>>> >>>>>>> I would like to know where we can get newer version of documentation >>>> for >>>>>>> Cloudstack. Look like the documentation site is not updated since >>>> 4.2.0. I >>>>>>> know that the documentation system will change, is their any >>>> information >>>>>>> about it somewhere? >>>>>>> >>>>>>> >>>>>> Yes, it moved to it's own repository: https://git-wip-us.apache.org/ >>>>>> repos/asf?p=cloudstack-docs.git >>>>>> >>>>>> $ git clone >> https://git-wip-us.apache.org/repos/asf/cloudstack-docs.git >>>>>> >>>>>> From there you can probably build the docs yourself. Be aware that we >>>> are >>>>>> moving to RST. >>>>>> >>>>>> >>>>>> Also, I would like to contribute as well. >>>>>>> >>>>>>> >>>>>> Patches are always welcome! >>>>>> >>>>>> Thanks, >>>>>>> >>>>>>> Pierre-Luc Dion >>>>>>> Architecte de Solution Cloud | Cloud Solutions Architect >>>>>>> - - - >>>>>>> >>>>>>> *CloudOps*420 rue Guy >>>>>>> >>>>>>> Montréal QC H3J 1S6 >>>>>>> www.cloudops.com >>>>>>> @CloudOps_ >>>>>>> >>>>>>> >>>>>> >>>> >>>> >> >> > > -- > > Pierre-Luc Dion > Architecte de Solution Cloud | Cloud Solutions Architect > 514-447-3456, 1101 > - - - > > *CloudOps*420 rue Guy > Montréal QC H3J 1S6 > www.cloudops.com > @CloudOps_
