<html xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<meta name="Title" content="">
<meta name="Keywords" content="">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
        {font-family:"Cambria Math";
        panose-1:0 0 0 0 0 0 0 0 0 0;}
@font-face
        {font-family:Calibri;
        panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
        {margin:0in;
        margin-bottom:.0001pt;
        font-size:12.0pt;
        font-family:Calibri;}
a:link, span.MsoHyperlink
        {mso-style-priority:99;
        color:#0563C1;
        text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
        {mso-style-priority:99;
        color:#954F72;
        text-decoration:underline;}
span.EmailStyle17
        {mso-style-type:personal-compose;
        font-family:Calibri;
        color:windowtext;}
span.msoIns
        {mso-style-type:export-only;
        mso-style-name:"";
        text-decoration:underline;
        color:teal;}
.MsoChpDefault
        {mso-style-type:export-only;
        font-family:Calibri;}
@page WordSection1
        {size:8.5in 11.0in;
        margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
        {page:WordSection1;}
--></style>
</head>
<body bgcolor="white" lang="EN-US" link="#0563C1" vlink="#954F72">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt">Hi, <o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">[At the outset, I apologize, I may be late to this train. I hadn’t subscribed to this mailing list.]<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">The current structure of the install guide allows for a way to specify per-distro commands inside a file using the “only” directive. However, the install-guides that have been worked on so far have separate
 rst files for each distribution, examples: Heat [1] Magnum [2]. Spyros proposed to update the cookie-cutter to follow this style [3].
<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">While I think this is a fine approach… source content wise, that this is not as easily “maintainable”, because we are duplicating a lot of similar information between these documents. I wanted to mimic what
 openstack-manuals is doing with the current install-guide. I put up the manila patch [3], and it currently builds to targets ‘install-guide/build-rdo’, ‘install-guide/build-ubuntu’, ‘install-guide/build-obs’, ‘install-guide/build-debian’.
<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">I wanted to gather opinions on this approach.
<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">[1] http://docs.openstack.org/project-install-guide/orchestration/draft/index.html<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">[2] https://review.openstack.org/#/c/330051/<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">[3] https://review.openstack.org/#/c/332161/<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">[4] https://review.openstack.org/#/c/317152/
<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">Thanks, <o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt">Goutham<o:p></o:p></span></p>
</div>
</body>
</html>