<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Sat, Jan 28, 2017 at 6:29 AM, Alexandra Settle <span dir="ltr"><<a href="mailto:a.settle@outlook.com" target="_blank">a.settle@outlook.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<div bgcolor="white" lang="EN-US">
<div class="gmail-m_-4930755652470121262WordSection1">
<p class="MsoNormal">Hi Leong,<u></u><u></u></p>
<p class="MsoNormal"><u></u> <u></u></p>
<p class="MsoNormal">I have replied to your email that you send to Lana and I <span style="font-family:wingdings">
J</span> hopefully my answers help.<u></u><u></u></p>
<p class="MsoNormal"><u></u> <u></u></p>
<p class="MsoNormal">I think the best option for this would be to include this in the Deployment Guides section:
<a href="http://docs.openstack.org/project-deploy-guide/newton/" target="_blank">http://docs.openstack.org/<wbr>project-deploy-guide/newton/</a>
<u></u><u></u></p>
<p class="MsoNormal"><u></u> <u></u></p>
<p class="MsoNormal">Using these instructions: <a href="http://docs.openstack.org/contributor-guide/project-deploy-guide.html" target="_blank">
http://docs.openstack.org/<wbr>contributor-guide/project-<wbr>deploy-guide.html</a> <u></u><u></u></p>
<p class="MsoNormal"><u></u> <u></u></p>
<p class="MsoNormal">Does anyone have any other suggestions that might help Leong?<u></u><u></u></p>
<p class="MsoNormal"><u></u> </p></div></div></blockquote><div><br></div><div>Hi Alex and Leong and all,</div><div><br></div><div><br></div><div>This is the document set I mentioned in my API report last week.</div><div><a href="http://lists.openstack.org/pipermail/openstack-docs/2017-January/009540.html">http://lists.openstack.org/pipermail/openstack-docs/2017-January/009540.html</a><br></div><div><br></div><div>In my view, these belong on <a href="http://developer.openstack.org">developer.openstack.org</a> and not <a href="http://docs.openstack.org">docs.openstack.org</a>. It's not a deployment guide for deploying OpenStack but rather about apps on OpenStack. Still, the deployment guide is the latest new document build so I'll point to that in a sec.</div><div><br></div><div>I'd like this to go on <a href="http://developer.openstack.org">developer.openstack.org</a>, and you will need to also determine where to put it on that front page so that people can find it easily.</div><div><br></div><div>As I noted on IRC, this type of maintenance work is the responsibility of your team and not something that the docs team takes on as their own. I hope that makes sense. Feel free to ask more specific questions. We are happy to support and help.</div><div><br></div><div>Next steps, to me, are:</div><div><br></div><div>1. Propose a patch for where this would link to from the landing page on <a href="http://developer.openstack.org">developer.openstack.org</a>, by editing the page at <a href="https://github.com/openstack/api-site/blob/master/www/index.html">https://github.com/openstack/api-site/blob/master/www/index.html</a>.</div><div>2. Propose build patches similar to this one: <a href="https://review.openstack.org/#/c/391499/">https://review.openstack.org/#/c/391499/</a> which was the most recent new guide.</div><div>3. Make sure your doc pages link to your existing bug queue by configuring the conf.py (I think you said you already have one for tracking). <a href="https://github.com/openstack/api-site/blob/master/api-quick-start/source/conf.py#L74">https://github.com/openstack/api-site/blob/master/api-quick-start/source/conf.py#L74</a> is an example, and also documented here <a href="https://github.com/openstack/openstackdocstheme#using-the-theme">https://github.com/openstack/openstackdocstheme#using-the-theme</a>.</div><div><br></div><div>What do you think?</div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div bgcolor="white" lang="EN-US"><div class="gmail-m_-4930755652470121262WordSection1"><p class="MsoNormal"><u></u></p>
<p class="MsoNormal">Thanks,<u></u><u></u></p>
<p class="MsoNormal"><u></u> <u></u></p>
<p class="MsoNormal">Alex<u></u><u></u></p>
<p class="MsoNormal"><u></u> <u></u></p>
<div style="border-right:none;border-bottom:none;border-left:none;border-top:1pt solid rgb(181,196,223);padding:3pt 0in 0in">
<p class="MsoNormal" style="margin-left:0.5in"><b><span style="color:black">From: </span>
</b><span style="color:black">"Sun, Yih Leong" <<a href="mailto:yih.leong.sun@intel.com" target="_blank">yih.leong.sun@intel.com</a>><br>
<b>Date: </b>Friday, January 27, 2017 at 8:05 PM<br>
<b>To: </b>"<a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.<wbr>openstack.org</a>" <<a href="mailto:openstack-docs@lists.openstack.org" target="_blank">openstack-docs@lists.<wbr>openstack.org</a>><br>
<b>Cc: </b>"Barrett, Carol L" <<a href="mailto:carol.l.barrett@intel.com" target="_blank">carol.l.barrett@intel.com</a>>, 'Shamail Tahir' <<a href="mailto:itzShamail@gmail.com" target="_blank">itzShamail@gmail.com</a>>, "'<a href="mailto:rossetti.megan18@gmail.com" target="_blank">rossetti.megan18@gmail.com</a>'" <<a href="mailto:rossetti.megan18@gmail.com" target="_blank">rossetti.megan18@gmail.com</a>><br>
<b>Subject: </b>[OpenStack-docs] EWG Workload Reference Architecture</span><span style="font-size:12pt;color:black"><u></u><u></u></span></p>
</div><div><div class="gmail-h5">
<div>
<p class="MsoNormal" style="margin-left:0.5in"><span style="font-family:"times new roman""><u></u> <u></u></span></p>
</div>
<p class="MsoNormal" style="margin-left:0.5in">Hi documentation team, <u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in"> <u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">This is Leong from Intel and lead few efforts from OpenStack Enterprise WG (EWG).<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">(apologize for the long email below as I tried to elaborate the history and the intention here).<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in"> <u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">I would like to propose to include EWG Workload Reference Architecture as one of the published content at
<a href="https://docs.openstack.org" target="_blank">https://docs.openstack.org</a>.<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in"> <u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">EWG is developing a series of 'user/tenant-level' workload reference architectures (e.g. eCommerce, video processing) to help users to learn and understand how to deploy different types of applications/workloads
unto an OpenStack Cloud. These reference architectures describe the list of OpenStack services that can be used to support the workload and provides sample code (e.g. Heat, Murano, etc) to bootstrap the workload environment on an OpenStack Cloud.
<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in"> <u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">In the previous cycle, we worked with Foundation and produced two Workload Reference Architecture (Web Applications [1] and Big Data [2]) and published to OpenStack Sample Config [3]. We used to develop these content
on Google Doc with biweekly voice-call meeting. Once the content is ready, we pass over to Foundation's technical writer for final editing and graphic design.
<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in"> <u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">The target audience of these workload reference architecture is primarily operator users or app developer who deploy applications on cloud.<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">It is similar like a “sample manual / tutorial / user guides”<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in"> <u></u><u></u></p>
<p class="gmail-m_-4930755652470121262MsoPlainText" style="margin-left:0.5in">We are looking to improve the overall process:<u></u><u></u></p>
<p class="gmail-m_-4930755652470121262MsoPlainText" style="margin-left:0.5in">(1) to engage more content contributor/reviewer across different timezone<u></u><u></u></p>
<p class="gmail-m_-4930755652470121262MsoPlainText" style="margin-left:0.5in">(2) to streamline the review and publishing process so that final content (either new workload or revision to existing one) can be made available as soon as possible.
<u></u><u></u></p>
<p class="gmail-m_-4930755652470121262MsoPlainText" style="margin-left:0.5in">(3) to standardize content publication through Docs guideline with a common landing page at <a href="http://docs.openstack.org" target="_blank">docs.openstack.org</a> for App Deployer/Developer to consume.<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in"> <u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">We have started the process to move the “content development” to git/gerrit.
<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">We have setup a EWG repo [4,5] and included under UC governance [6].<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">We are wondering how we can collaborate with Docs team and publish the content onto
<a href="https://docs.openstack.org" target="_blank">https://docs.openstack.org</a>?<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">Any suggestion would mostly welcome!<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in"> <u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">Thanks!<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in"> <u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">[1] <a href="https://www.openstack.org/assets/software/mitaka/OpenStack-WorkloadRefArchWebApps-v7.pdf" target="_blank">
https://www.openstack.org/<wbr>assets/software/mitaka/<wbr>OpenStack-<wbr>WorkloadRefArchWebApps-v7.pdf</a><u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">[2] <a href="https://www.openstack.org/assets/software/mitaka/OpenStack-WorkloadRefBigData-v4.pdf" target="_blank">
https://www.openstack.org/<wbr>assets/software/mitaka/<wbr>OpenStack-WorkloadRefBigData-<wbr>v4.pdf</a><u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">[3] <a href="https://www.openstack.org/software/sample-configs/" target="_blank">
https://www.openstack.org/<wbr>software/sample-configs/</a><u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">[4] <a href="https://github.com/openstack/workload-ref-archs" target="_blank">
https://github.com/openstack/<wbr>workload-ref-archs</a><u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">[5] <a href="https://github.com/openstack/workload-ref-archs/tree/master/workload-ref-archs/web-applications" target="_blank">
https://github.com/openstack/<wbr>workload-ref-archs/tree/<wbr>master/workload-ref-archs/web-<wbr>applications</a><u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">[6] <a href="https://review.openstack.org/#/c/423413/" target="_blank">
https://review.openstack.org/#<wbr>/c/423413/</a><u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in"> <u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">---<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">Yih <b><u>Leong</u></b> Sun, PhD <u></u>
<u></u></p>
<p class="MsoNormal" style="margin-left:0.5in">Senior Software Cloud Architect | Open Source Technology Center | Intel Corporation<u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in"><a href="mailto:yih.leong.sun@intel.com" target="_blank">yih.leong.sun@intel.com</a> | <a href="tel:(503)%20264-0610" value="+15032640610" target="_blank">+1 503 264 0610</a><u></u><u></u></p>
<p class="MsoNormal" style="margin-left:0.5in"> <u></u><u></u></p>
</div></div></div>
</div>
<br>______________________________<wbr>_________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.<wbr>openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/<wbr>openstack-docs</a><br>
<br></blockquote></div><br><br clear="all"><div><br></div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div dir="ltr"><div dir="ltr"><div><br></div><div>Read my blog: <a href="https://justwriteclick.com" target="_blank">justwrite.click</a></div><div>Subscribe to Docs|Code: <a href="http://docslikecode.com" target="_blank">docslikecode.com</a> </div></div></div></div></div></div></div>
</div></div>