[OpenStack-docs] Fwd: [config-ref-rst] block-storage/drivers/huawei-storage-driver.. Repetitive Procedures

Andreas Jaeger aj at suse.com
Tue Dec 15 07:22:00 UTC 2015


Hi Njira,

> Good day everyone.
>
> Advice is needed before proceeding with the Configuration Reference
> Guide Migration.
> <https://wiki.openstack.org/wiki/Documentation/Migrate#Configuration_Reference_Guide_Migration>
>
> The Huawei Storage Drivers file
> <http://docs.openstack.org/liberty/config-reference/content/huawei-storage-driver.html>
> describes how to configure volume drivers for different products for the
> Fibre Channel and iSCI storage products. Each description for each
> product is exactly the same 5 steps differing in only the exact 2 lines
> for all of them.
>
> The clarification I am seeking is if it is in order to merge all these
> descriptions into one description of 5 steps and differentiate each
> product by the different lines or to just repeat the same steps for each
> product.

I like your proposal of merging, go ahead!

thanks
Andreas


>
> *_Example of how it currently is:
> _
> *
> *Configure Product One
> *
> 1. Do first step.
> 2. Another step here
> 3. Yet another step
> 4. Product one unique step
> 5. Final step
>
> *Configure Product Two
> *1. Do first step.
> 2. Another step here
> 3. Yet another step
> 4. Product two unique step
> 5. Final step
>
> *Configure Product Three
> *1. Do first step.
> 2. Another step here
> 3. Yet another step
> 4. Product three unique step
> 5. Final step
>
>
> *_Example of how it can be:
>
> _*
> *Configure a Product
> *
> 1. Do first step.
> 2. Another step here
> 3. Yet another step
>
> For Product one:
> 4. Product one unique step
> For Product two:
> 4. Product two unique step
> For Product three:
> 4. Product three unique step
>
> 5. Final step
>
> Here is a file example for the long repetitive one
> <https://review.openstack.org/257569/3/doc/config-ref-rst/source/block-storage/drivers/huawei-storage-driver.rst>
>
>
> _______________________________________________
> OpenStack-docs mailing list
> OpenStack-docs at lists.openstack.org
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs
>


-- 
  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




More information about the OpenStack-docs mailing list