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

Njira Perci njirap at gmail.com
Tue Dec 15 00:22:55 UTC 2015


---------- Forwarded message ----------
From: "Njira Perci" <njirap at gmail.com>
Date: Dec 15, 2015 3:10 AM
Subject: [config-ref-rst] block-storage/drivers/huawei-storage-driver..
Repetitive Procedures
To: <openstack-doc at lists.openstack.org>



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.



*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>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-docs/attachments/20151215/3d1c4061/attachment-0001.html>


More information about the OpenStack-docs mailing list