Mailing-List: contact dev-help@cloudstack.apache.org; run by ezmlm
Precedence: bulk
Reply-To: dev@cloudstack.apache.org
Received-SPF: pass (nike.apache.org: domain of runseb@gmail.com designates
 74.125.83.46 as permitted sender)
Content-Type: text/plain; charset=windows-1252
Mime-Version: 1.0 (Mac OS X Mail 6.6 \(1510\))
Subject: Re: Cloudstack documentation
From: sebgoa <runseb@gmail.com>
In-Reply-To: 
 <CAD97ioccJmm9J-CFaBR1b1tEDC49aAMo99KAB7HaXw7ZeAGqqQ@mail.gmail.com>
Date: Tue, 18 Mar 2014 16:25:51 +0100
Content-Transfer-Encoding: quoted-printable
Message-Id: <98F01E4D-F580-4349-9CFA-966C1661173C@gmail.com>
References: 
 <CAD97iocCx0mUPAss+sheg2GRT+pvg9A=_dUuwGEspDVU0FgwEw@mail.gmail.com>
 <532846F0.8070405@widodh.nl>
 <CAD97iodifPqjBLhrMS4wWagks6_UggBzuQLP_h4Yv9Hcc=h+zg@mail.gmail.com>
 <E29BB930-9CA5-46CB-BD71-575073928CC9@gmail.com>
 <CAD97ioccJmm9J-CFaBR1b1tEDC49aAMo99KAB7HaXw7ZeAGqqQ@mail.gmail.com>
To: dev@cloudstack.apache.org


On Mar 18, 2014, at 3:50 PM, Pierre-Luc Dion <pdion@cloudops.com> wrote:

> Thanks Sebastien,
>=20
>=20
> 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=85haven't touched that one =
yet :)

-sebastien

>=20
>=20
>=20
> Pierre-Luc Dion
> Architecte de Solution Cloud | Cloud Solutions Architect
> 514-447-3456, 1101
> - - -
>=20
> *CloudOps*420 rue Guy
> Montr=E9al QC  H3J 1S6
> www.cloudops.com
> @CloudOps_
>=20
>=20
> On Tue, Mar 18, 2014 at 10:16 AM, sebgoa <runseb@gmail.com> wrote:
>=20
>>=20
>> On Mar 18, 2014, at 3:02 PM, Pierre-Luc Dion <pdion@cloudops.com> =
wrote:
>>=20
>>> Thanks Wido,
>>>=20
>>> 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?
>>=20
>> It' already done :) I'd be mean I would tell you to search the =
mailing
>> list :)
>>=20
>> If you search the cloudstack mirrors on github:
>> https://github.com/orgs/apache?query=3Dcloudstack
>>=20
>> 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)
>>=20
>> 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.
>>=20
>> These docs are pushed automatically to readthedocs.org and provide:
>>=20
>> 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
>>=20
>> I am actively working on cleaning this up and fixing the URLs/CNAMEs.
>>=20
>> 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.
>>=20
>> There is still lots of work to do, both on the formatting (the =
conversion
>> was not perfect) and the content of course.
>>=20
>> Have at it, I'd be delighted to merge your patches :)
>>=20
>> -sebastien
>>=20
>>>=20
>>>=20
>>>=20
>>>=20
>>> Pierre-Luc Dion
>>> Architecte de Solution Cloud | Cloud Solutions Architect
>>> 514-447-3456, 1101
>>> - - -
>>>=20
>>> *CloudOps*420 rue Guy
>>> Montr=E9al QC  H3J 1S6
>>> www.cloudops.com
>>> @CloudOps_
>>>=20
>>>=20
>>> On Tue, Mar 18, 2014 at 9:15 AM, Wido den Hollander <wido@widodh.nl>
>> wrote:
>>>=20
>>>> On 03/18/2014 02:08 PM, Pierre-Luc Dion wrote:
>>>>=20
>>>>> Hi all,
>>>>>=20
>>>>> 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?
>>>>>=20
>>>>>=20
>>>> Yes, it moved to it's own repository: =
https://git-wip-us.apache.org/
>>>> repos/asf?p=3Dcloudstack-docs.git
>>>>=20
>>>> $ git clone =
https://git-wip-us.apache.org/repos/asf/cloudstack-docs.git
>>>>=20
>>>> =46rom there you can probably build the docs yourself. Be aware =
that we
>> are
>>>> moving to RST.
>>>>=20
>>>>=20
>>>> Also, I would like to contribute as well.
>>>>>=20
>>>>>=20
>>>> Patches are always welcome!
>>>>=20
>>>> Thanks,
>>>>>=20
>>>>> Pierre-Luc Dion
>>>>> Architecte de Solution Cloud | Cloud Solutions Architect
>>>>> - - -
>>>>>=20
>>>>> *CloudOps*420 rue Guy
>>>>>=20
>>>>> Montr=E9al QC  H3J 1S6
>>>>> www.cloudops.com
>>>>> @CloudOps_
>>>>>=20
>>>>>=20
>>>>=20
>>=20
>>=20