<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:"Times New Roman";}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:blue;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:purple;
text-decoration:underline;}
span.EmailStyle17
{mso-style-type:personal-reply;
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-size:10.0pt;}
@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="blue" vlink="purple">
<div class="WordSection1">
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">Hi Abraham,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">Will the documentation at
<a href="https://docs.openstack.org/starlingx">https://docs.openstack.org/starlingx</a> be both Developer Documentation and User Documentation ?<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">( I’m assuming that it will NOT be API documentation, I see discussions on that elsewhere. And would be located at
<a href="https://developer.openstack.org/api-ref/starlingx/">https://developer.openstack.org/api-ref/starlingx/</a> ??? )<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">I am the main reviewer for all existing User Documentation for Titanium Cloud,<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">so I’ll volunteer on being a core reviewer for this StarlingX Documentation ... please add me to the appropriate email lists.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri">Thanks,<br>
Greg.<o:p></o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"><o:p> </o:p></span></p>
<p class="MsoNormal"><span style="font-size:11.0pt;font-family:Calibri"><o:p> </o:p></span></p>
<div style="border:none;border-top:solid #B5C4DF 1.0pt;padding:3.0pt 0in 0in 0in">
<p class="MsoNormal"><b><span style="font-family:Calibri;color:black">From: </span>
</b><span style="font-family:Calibri;color:black">"Arce Moreno, Abraham" <abraham.arce.moreno@intel.com><br>
<b>Date: </b>Wednesday, August 1, 2018 at 11:54 AM<br>
<b>To: </b>"starlingx-discuss@lists.starlingx.io" <starlingx-discuss@lists.starlingx.io><br>
<b>Subject: </b>[Starlingx-discuss] StarlingX Documentation Initial Template<o:p></o:p></span></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Dean,<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Here you have the high level overview of tasks to get started with our " StarlingX Documentation".<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">@Hayde has raised her hand to help in this short term not time consuming assignment.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Objective: Create a first "Gold Initial Commit" based in "Stx-Docs" project including high level requirements<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">from OpenStack Documentation Guidelines so it can ported into the rest of our StarlingX projects.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Phase 1:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">1. Learning Resources<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">1.1 Read "OpenStack Documentation Contributor Guide"<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <a href="https://docs.openstack.org/doc-contrib-guide/index.html">
https://docs.openstack.org/doc-contrib-guide/index.html</a><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">2. Initial Code<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">2.1 Understand existing "Stx-Docs" repository and "docs/" implementation<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"> <a href="https://review.openstack.org/#/q/project:openstack/stx-docs">
https://review.openstack.org/#/q/project:openstack/stx-docs</a><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">3. Translate important topics from "OpenStack Documentation Contributor Guide" into "Stx-Docs" commits:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">3.1 Project guide setup<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">3.2 Writing documentation<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">3.3 Writing style<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">3.4 Building documentation<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">3.5 Landing pages on docs.openstack.org<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">4. Get Final Gerrit Reviews on commits and make changes<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">5. Have our "Gold Initial Commit" ready<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Phase 2:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">Once the first interaction is done we can take another repository to test our "Gold Initial Commit"<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">having only modifications at the content level.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Phase 3:<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">With 2 interactions we are ready to easily move what we have learned and implemented in 2 projects to<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">the rest of our StarlingX projects.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">Happy to hear your thoughts.<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
<div>
<p class="MsoNormal">_______________________________________________<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal">Starlingx-discuss mailing list<o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><a href="mailto:Starlingx-discuss@lists.starlingx.io">Starlingx-discuss@lists.starlingx.io</a><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><a href="http://lists.starlingx.io/cgi-bin/mailman/listinfo/starlingx-discuss">http://lists.starlingx.io/cgi-bin/mailman/listinfo/starlingx-discuss</a><o:p></o:p></p>
</div>
<div>
<p class="MsoNormal"><o:p> </o:p></p>
</div>
</div>
</body>
</html>