Open Stack

On 2016-05-09 02:08, Tomoyuki Kato wrote:
> 
>> We had some discussions in Austin on how to go forward with the Install
>> Guides and I've wrote up a couple of steps.
>>
>> Note that this is not complete but something for us to discuss. Lana,
>> please add what we agree on in your spec.
>>
>>
>> 1) Cookiecutter for project specific install guides with basic
>>   structure. Make this part of docs team repos...
>>
>>   First draft at:
>>   https://github.com/ajaeger/cookiecutter-installguide
>>
>>   A cookiecutter allows a project to easily setup the structure for the
>> guide. Please review what I've done and see whether that works.
> 
> Nice work!
> Do we use "only" directive for each distro?

I would leave that to the project teams. Or we could give some
recommendation on either way.

We should make a script available to build multiple distros if we
recommend it.


> I don't want to use it to avoid complex things for Advanced Install Guide.
> Alternatively, I'd like to add the conditional description. For example,
> 
>   1. install the packages:
>       For Ubuntu,
>               xxxx
>       For xxxx,
>               xxxx ....

Might be the easier way, and we could advise on doing it this way...

Andreas
-- 
 Andreas Jaeger aj@{suse.com,opensuse.org} Twitter: jaegerandi
  SUSE LINUX GmbH, Maxfeldstr. 5, 90409 Nürnberg, Germany
   GF: Felix Imendörffer, Jane Smithard, Graham Norton,
       HRB 21284 (AG Nürnberg)
    GPG fingerprint = 93A3 365E CE47 B889 DF7F FED1 389A 563C C272 A126