<div dir="ltr">Seems like a good idea considering all of the other specialty teams.</div><div class="gmail_extra"><br><div class="gmail_quote">On Tue, Feb 17, 2015 at 7:28 PM, Joseph Robinson <span dir="ltr"><<a href="mailto:joseph.robinson@rackspace.com" target="_blank">joseph.robinson@rackspace.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class=""><br>
<br>
On 4/02/2015 8:59 am, "Lana Brindley" <<a href="mailto:openstack@lanabrindley.com">openstack@lanabrindley.com</a>> wrote:<br>
<br>
>Hi everyone,<br>
><br>
>First of all: Hi Tanja, and welcome!<br>
><br>
>After reading this email, I was thinking about the end user guides we<br>
>have in OpenStack, and wondering if people felt there would be value in<br>
>creating a User Guide speciality team.<br>
<br>
</span>Sounds like a good move.<br>
<span class="">><br>
>It would give us a space to have conversations like this (about<br>
>enterprise content), support companies who reuse upstream content from<br>
>the guides, and also get some focus on information architecture,<br>
>consistency, and conventions in these guides.<br>
<br>
</span>Working on consistency and IA sounds interesting, and I¹d be good to<br>
volunteer on this point.<br>
<div class="HOEnZb"><div class="h5">><br>
>I'm happy to stand up and run meetings, etc, as long as other people are<br>
>interested. Thoughts?<br>
><br>
>Lana<br>
><br>
>On 21/01/15 02:43, Tanja Roth wrote:<br>
>> Hi Anne, hi all,<br>
>><br>
>> I'm new to this list and I'm a member of the SUSE doc team. I have been<br>
>> working on the SUSE Cloud End User Guide and Admin User Guide since<br>
>> some time.<br>
>><br>
>> So far, my direct contributions to the OpenStack project mostly<br>
>> consisted of (usability) bug reports for Horizon. For the upcoming<br>
>> releases, we would like to contribute to the OpenStack docs directly,<br>
>> especially to the Admin User Guide and End User Guide.<br>
>><br>
>> Andreas was so kind to help me set up the OpenStack doc environment last<br>
>> week. My first contribution was to fix two typos in the Admin User<br>
>> Guide that I had stumbled across lately. ;)<br>
>><br>
>> I'm currently evaluating how big the diff between the SUSE and the<br>
>> OpenStack versions of both guides is (and trying to identify snippets<br>
>> that would perhaps be worth integrating in the OpenStack docs).<br>
>><br>
>> Before moving on, I'd like to get your advice on how to proceed with<br>
>> the following:<br>
>><br>
>> 1) What to do with the doc bug reports we have for both guides in<br>
>> SUSE-Bugzilla? Should I / do I need to transfer them to launchpad in<br>
>> order to fix them in the upstream docs?<br>
>><br>
>> 2) What to do in case we need SUSE-specific content in the manuals?<br>
>>     - For example, we have a bug report asking to specify which guests<br>
>>       are supported by SUSE Cloud.<br>
>><br>
>>     - We have some sections [1] that contain SUSE-specific instructions<br>
>>       (e.g how to build images in SUSE Studio and image requirements<br>
>>       related to that) - what to do with those?<br>
>><br>
>> Andreas told me that profiling (conditional output) for<br>
>> distribution-specific content is only used in the Installation Guide.<br>
>><br>
>> Should I add SUSE-specific content for the Admin User/End User Guide<br>
>> simply in a para (or within a section) by saying "For SUSE Linux<br>
>> Enterprise or openSUSE, do [...]"? If yes, would that be acceptable<br>
>> also for snippets longer than (let's say) 1-2 sentences?<br>
>><br>
>> Thanks in advance!<br>
>><br>
>> BTW, the HowTo instructions [2] and the Documentation conventions [3]<br>
>> are really helpful for new contributors! But I'm pretty sure that I<br>
>> will have some more questions to you in the future. If those questions<br>
>> have already been discussed or answered before, feel free to point me<br>
>> to the right places (mailing list archives etc.). :)<br>
>><br>
>> -----<br>
>> [1]<br>
>><br>
>><a href="https://www.suse.com/documentation/suse-cloud4/book_cloud_admin/data/sec_" target="_blank">https://www.suse.com/documentation/suse-cloud4/book_cloud_admin/data/sec_</a><br>
>>adm_cli_img.html#sec_adm_cli_img_build<br>
>><br>
>> [2] <a href="https://wiki.openstack.org/wiki/Documentation/HowTo" target="_blank">https://wiki.openstack.org/wiki/Documentation/HowTo</a><br>
>><br>
>> [3] <a href="https://wiki.openstack.org/wiki/Documentation/Conventions" target="_blank">https://wiki.openstack.org/wiki/Documentation/Conventions</a><br>
>><br>
>><br>
>> Kind regards,<br>
>><br>
>> Tanja Roth, Documentation<br>
>> SUSE Linux GmbH<br>
>><br>
>> GF: Felix Imendörffer, Jane Smithard, Jennifer Guild, Dilip Upmanyu,<br>
>> Graham Norton HRB 21284 (AG Nürnberg)<br>
>><br>
>><br>
>><br>
>><br>
>> _______________________________________________<br>
>> OpenStack-docs mailing list<br>
>> <a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
>> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
>><br>
><br>
><br>
>--<br>
>Lana Brindley<br>
>Technical Writer<br>
>Rackspace Cloud Builders Australia<br>
><a href="http://lanabrindley.com" target="_blank">http://lanabrindley.com</a><br>
><br>
>_______________________________________________<br>
>OpenStack-docs mailing list<br>
><a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
><a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
<br>
<br>
_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</div></div></blockquote></div><br></div>