← Back to team overview

openstack team mailing list archive

Re: Debianizing Documentation

 

Yes, patches are accepted only through Gerrit. I've written up a
"First time contributors" section here:
http://wiki.openstack.org/Documentation/HowTo#First-time_Contributors

The Starter Guide is housed in Launchpad at:
https://launchpad.net/openstackbook
It is reviewed and merged through Launchpad merge requests by the CSS
OSS Team. It is also licensed differently from the other manuals and
it ships with Ubuntu server so it only documents Ubuntu.

Please edit http://docs.openstack.org/diablo/openstack-compute/install/content/
by adding Debian sections rather than editing the Starter Guide.

Definitely want to expand the Install Guide to include Debian.

Thanks,

Anne


On Thu, Mar 1, 2012 at 4:53 AM, Kiall Mac Innes <kiall@xxxxxxxxxxxx> wrote:
> Hi Alexey,
>
> It's my understanding that patches are only accepted via Gerrit -
> http://review.openstack.org/
>
> Gerrit is responsible for managing, among other things, code review and the
> CLA that is required before signing.
>
> https://rackspace.echosign.com/public/hostedForm?formid=3G7VVC397N783J ;<--
> CLA that needs signing..
> http://wiki.openstack.org/Contributors ;<-- Once you get a confirmation back
> - Add the number and your launchapd ID here
> https://launchpad.net/~openstack-cla/+join ;<-- After your ID is listed on
> the page above, Join this group..
> http://wiki.openstack.org/GerritWorkflow ;<-- Finally, submit patches..
>
> I know there is a wiki page somewhere with these links etc - But I couldn't
> find it faster than the individual links ;)
>
> Thanks,
> Kiall
>
>
>
> On Thu, Mar 1, 2012 at 4:37 AM, Alexey Eromenko <al4321@xxxxxxxxx> wrote:
>>
>> OK, first version of Debianized nova-docs, for review:
>>
>> [PATCH] Docs: Debianizing The Manuals, v01
>> https://bugs.launchpad.net/openstack-manuals/+bug/943792
>>
>> Where are the sources of the Starter Guide ?
>>
>>
>> myuser@nova-server1:~/openstack-manuals/doc/src/docbkx/openstack-compute-admin$
>> ls ..
>> api-quick-start            openstack-identity-service-starter
>> common                     openstack-image-service-admin
>> docbkx-example             openstack-install
>> openstack-api-programming  openstack-network-connectivity-admin
>> openstack-api-site         openstack-object-storage-admin
>> openstack-compute-admin
>>
>> ===============================================================
>> PATCH:
>> +++ computeinstall.xml  2012-02-29 23:25:44.000000000 -0500
>> @@ -127,6 +127,46 @@
>>                 clicking the links next to the manual title.</para>
>>         </section>
>>     </section>
>> +
>> +    <section xml:id="installing-openstack-compute-on-debian">
>> +        <title>Installing OpenStack Compute on Debian</title>
>> +        <para>Starting with Debian 7.0 "Wheezy", the OpenStack packages
>> are
>> +            provided as part of the distribution.</para>
>> +            <para>
>> +              For the management node install the following packages:
>> (via apt-get install)
>> +        <literallayout class="monospaced">
>> +nova-api
>> +nova-scheduler
>> +glance
>> +keystone
>> +mysql-server
>> +rabbitmq
>> +memcached
>> +openstack-dashboard
>> +        </literallayout>
>> +            </para>
>> +            <para>
>> +              For the compute node(s) install the following packages:
>> +        <literallayout class="monospaced">
>> +nova-compute
>> +nova-network
>> +nova-api
>> +        </literallayout>
>> +            </para>
>> +          <note>
>> +            <para>
>> +              Because this manual takes active advantage of the "sudo"
>> command,
>> +              it would be easier for you to add to it your Debian
>> system, by doing:
>> +              <literallayout class="monospaced">
>> +# usermod -a -G sudo "myuser"
>> +              </literallayout>
>> +              then re-login.
>> +              Otherwise you will have to replace every "sudo" call by
>> executing from
>> +              root account.
>> +          </para>
>> +        </note>
>> +    </section>
>> +
>>     <section xml:id="installing-openstack-compute-on-rhel6">
>>         <title>Installing OpenStack Compute on Red Hat Enterprise
>> Linux 6 </title>
>>         <para>This section documents a multi-node installation using
>> RHEL 6. RPM repos for the Bexar
>>
>> --
>> -Alexey Eromenko "Technologov"
>>
>> _______________________________________________
>> Mailing list: https://launchpad.net/~openstack
>> Post to     : openstack@xxxxxxxxxxxxxxxxxxx
>> Unsubscribe : https://launchpad.net/~openstack
>> More help   : https://help.launchpad.net/ListHelp
>
>
>
> _______________________________________________
> Mailing list: https://launchpad.net/~openstack
> Post to     : openstack@xxxxxxxxxxxxxxxxxxx
> Unsubscribe : https://launchpad.net/~openstack
> More help   : https://help.launchpad.net/ListHelp
>


References