<html dir="ltr">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
<style>
<!--
@font-face
{font-family:SimSun}
@font-face
{font-family:"Cambria Math"}
@font-face
{font-family:Calibri}
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0cm;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri","sans-serif"}
a:link, span.MsoHyperlink
{color:blue;
text-decoration:underline}
a:visited, span.MsoHyperlinkFollowed
{color:purple;
text-decoration:underline}
p.MsoListParagraph, li.MsoListParagraph, div.MsoListParagraph
{margin-top:0cm;
margin-right:0cm;
margin-bottom:0cm;
margin-left:36.0pt;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri","sans-serif"}
span.EmailStyle17
{font-family:"Calibri","sans-serif";
color:#1F497D}
@page WordSection1
{margin:72.0pt 72.0pt 72.0pt 72.0pt}
ol
{margin-bottom:0cm}
ul
{margin-bottom:0cm}
-->
</style><style id="owaParaStyle" type="text/css">P {margin-top:0;margin-bottom:0;}</style>
</head>
<body ocsi="0" fpstyle="1" lang="EN-CA" link="blue" vlink="purple">
<div style="direction: ltr;font-family: Tahoma;color: #000000;font-size: 10pt;">Heat added a panel in horizon to describe all the resources they have. Not sure you would want to do it the same way, but there is at least one other project that ran into this
issue and took a stab at solving it. Might be worth a look.<br>
<br>
Thanks,<br>
Kevin<br>
<div style="font-family: Times New Roman; color: #000000; font-size: 16px">
<hr tabindex="-1">
<div style="direction: ltr;" id="divRpF35618"><font face="Tahoma" color="#000000" size="2"><b>From:</b> Hongbin Lu [hongbin.lu@huawei.com]<br>
<b>Sent:</b> Wednesday, May 11, 2016 12:52 PM<br>
<b>To:</b> OpenStack Development Mailing List (not for usage questions)<br>
<b>Cc:</b> Qun XK Wang<br>
<b>Subject:</b> [openstack-dev] [magnum] How to document 'labels'<br>
</font><br>
</div>
<div></div>
<div>
<div class="WordSection1">
<p class="MsoNormal"><span style="color:#1F497D">Hi all,</span></p>
<p class="MsoNormal"><span style="color:#1F497D"> </span></p>
<p class="MsoNormal"><span style="color:#1F497D">This is a continued discussion from the last team meeting. For recap, ‘labels’ is a property in baymodel and is used by users to input additional key-pair pairs to configure the bay. In the last team meeting,
we discussed what is the best way to document ‘labels’. In general, I heard three options:</span></p>
<p class="MsoListParagraph" style="text-indent:-18.0pt"><span style="color:#1F497D"><span style="">1.<span style="font:7.0pt "Times New Roman"">
</span></span></span><span style="color:#1F497D">Place the documentation in Magnum CLI as help text (as Wangqun proposed [1][2]).</span></p>
<p class="MsoListParagraph" style="text-indent:-18.0pt"><span style="color:#1F497D"><span style="">2.<span style="font:7.0pt "Times New Roman"">
</span></span></span><span style="color:#1F497D">Place the documentation in Magnum server and expose them via the REST API. Then, have the CLI to load help text of individual properties from Magnum server.</span></p>
<p class="MsoListParagraph" style="text-indent:-18.0pt"><span style="color:#1F497D"><span style="">3.<span style="font:7.0pt "Times New Roman"">
</span></span></span><span style="color:#1F497D">Place the documentation in a documentation server (like developer.openstack.org/…), and add the doc link to the CLI help text.</span></p>
<p class="MsoNormal"><span style="color:#1F497D">For option #1, I think an advantage is that it is close to end-users, thus providing a better user experience. In contrast, Tom Cammann pointed out a disadvantage that the CLI help text might be easier to become
out of date. For option #2, it should work but incurs a lot of extra work. For option #3, the disadvantage is the user experience (since user need to click the link to see the documents) but it makes us easier to maintain. I am thinking if it is possible to
have a combination of #1 and #3. Thoughts?</span></p>
<p class="MsoNormal"><span style="color:#1F497D"> </span></p>
<p class="MsoNormal"><span style="color:#1F497D">[1] <a href="https://review.openstack.org/#/c/307631/" target="_blank">
https://review.openstack.org/#/c/307631/</a></span></p>
<p class="MsoNormal"><span style="color:#1F497D">[2] <a href="https://review.openstack.org/#/c/307642/" target="_blank">
https://review.openstack.org/#/c/307642/</a></span></p>
<p class="MsoNormal"><span style="color:#1F497D"> </span></p>
<p class="MsoNormal"><span style="color:#1F497D">Best regards,</span></p>
<p class="MsoNormal"><span style="color:#1F497D">Hongbin</span></p>
</div>
</div>
</div>
</div>
</body>
</html>