<div dir="ltr"><br><div class="gmail_quote"><div dir="ltr">On Tue, Feb 6, 2018 at 12:37 PM Jeremy Freudberg <<a href="mailto:jeremyfreudberg@gmail.com">jeremyfreudberg@gmail.com</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">On Tue, Feb 6, 2018 at 6:53 AM, Telles Nobrega <<a href="mailto:tenobreg@redhat.com" target="_blank">tenobreg@redhat.com</a>> wrote:<br>
> Hi folks,<br>
><br>
> as we discussed in our last meeting, tomorrow (Wednesday 7th) we are going<br>
> to do a first overview of our documentation in order to gather the maximum<br>
> information of where we need to fix, add or remove stuff so we don't waste<br>
> time at PTG on this.<br>
<br>
+1<br>
<br>
><br>
> We can fix small problems but the main goal is to have a list of places that<br>
> need fixing, so we can use during Rocky cycle as a guide for documentation<br>
> improvement.<br>
><br>
> In order to maiximize our reach it would good to split where each of us will<br>
> be looking at the documentation, so I thought:<br>
><br>
> From:<br>
> <a href="https://docs.openstack.org/sahara/latest/" rel="noreferrer" target="_blank">https://docs.openstack.org/sahara/latest/</a> we can split in 4 parts, since<br>
> user guide seems to be biggest one person would work on User Guide, and<br>
> other 3 each work on 2 topics (we can choose freely)<br>
><br>
> From:<br>
> <a href="https://docs.openstack.org/sahara-tests/latest/" rel="noreferrer" target="_blank">https://docs.openstack.org/sahara-tests/latest/</a> it seems very direct, maybe<br>
> tosky and I can take a look at it (everyone is free to do so as well)<br>
<br>
There's the saharaclient docs as well - but they are quite short and I<br>
already read through most of them when I was working on the APIv2<br>
stuff. So I'll take the client docs, plus whatever other section in<br>
the main doc that you want to assign me :)<br>
<br>
><br>
> If anyone needs help, or the rabbit hole grows too much we can always<br>
> reorganize the split.<br>
><br>
> What do you think of it?<br>
<br>
Good plan. Although we should define our focus a bit better. Are we<br>
just trying to find outdated/incorrect stuff, or should we also be<br>
trying to look at the big picture? By big picture I mean trying to<br>
identify gaps, or thinking about organization and not just content.<br></blockquote><div><br></div><div><br></div><div>I don't believe this totally up to me, what do you think? I would say lets consider both cases, but work mainly on the outdated/incorrect stuff and at PTG/after we can work in more details on the big picture stuff. </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
><br>
> Thanks<br>
><br>
><br>
><br>
><br>
> --<br>
><br>
> TELLES NOBREGA<br>
><br>
> SOFTWARE ENGINEER<br>
><br>
> Red Hat Brasil<br>
><br>
> Av. Brg. Faria Lima, 3900 - 8º andar - Itaim Bibi, São Paulo<br>
><br>
> <a href="mailto:tenobreg@redhat.com" target="_blank">tenobreg@redhat.com</a><br>
><br>
> TRIED. TESTED. TRUSTED.<br>
> Red Hat é reconhecida entre as melhores empresas para trabalhar no Brasil<br>
> pelo Great Place to Work.<br>
><br>
> __________________________________________________________________________<br>
> OpenStack Development Mailing List (not for usage questions)<br>
> Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
><br>
<br>
__________________________________________________________________________<br>
OpenStack Development Mailing List (not for usage questions)<br>
Unsubscribe: <a href="http://OpenStack-dev-request@lists.openstack.org?subject:unsubscribe" rel="noreferrer" target="_blank">OpenStack-dev-request@lists.openstack.org?subject:unsubscribe</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
</blockquote></div></div>-- <br><div dir="ltr" class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><p class="inbox-inbox-inbox-inbox-inbox-fullname-container" style="box-sizing:border-box;color:rgb(0,0,0);font-family:overpass,sans-serif;font-weight:bold;margin:0px;padding:0px;font-size:14px;text-transform:uppercase"><span class="inbox-inbox-inbox-inbox-inbox-firstname-container" style="box-sizing:border-box">TELLES</span><span class="inbox-inbox-inbox-inbox-inbox-Apple-converted-space"> </span><span class="inbox-inbox-inbox-inbox-inbox-lastname-container" style="box-sizing:border-box">NOBREGA</span></p><p class="inbox-inbox-inbox-inbox-inbox-position-container" style="box-sizing:border-box;color:rgb(0,0,0);font-family:overpass,sans-serif;font-size:10px;margin:0px 0px 4px;text-transform:uppercase"><span class="inbox-inbox-inbox-inbox-inbox-position" style="box-sizing:border-box">SOFTWARE ENGINEER</span></p><p class="inbox-inbox-inbox-inbox-inbox-legal-container" style="box-sizing:border-box;font-family:overpass,sans-serif;margin:0px;font-size:10px;color:rgb(153,153,153)"><a class="inbox-inbox-inbox-inbox-inbox-redhat-anchor" href="https://www.redhat.com/" target="_blank" style="box-sizing:border-box;color:rgb(0,136,206);margin:0px;text-decoration:none"><font color="#0088ce" style="box-sizing:border-box;color:rgb(0,136,206);margin:0px;text-decoration:none"><span style="box-sizing:border-box;text-decoration-style:initial;text-decoration-color:initial">Red Hat Brasil</span></font><span class="inbox-inbox-inbox-inbox-inbox-Apple-converted-space" style="box-sizing:border-box;color:rgb(0,136,206);margin:0px;text-decoration:none"> </span></a></p><p class="inbox-inbox-inbox-inbox-inbox-legal-container" style="box-sizing:border-box;font-family:overpass,sans-serif;margin:0px;font-size:10px;color:rgb(153,153,153)">Av. Brg. Faria Lima, 3900 - 8º andar - Itaim Bibi, São Paulo</p><p class="inbox-inbox-inbox-inbox-inbox-contact-container" style="box-sizing:border-box;font-family:overpass,sans-serif;margin:0px 0px 6px;font-size:10px;color:rgb(153,153,153)"><span class="inbox-inbox-inbox-inbox-inbox-email-container" style="box-sizing:border-box;margin:0px;padding:0px"><a class="inbox-inbox-inbox-inbox-inbox-email-anchor" href="mailto:tenobreg@redhat.com" style="box-sizing:border-box;color:rgb(0,136,206);margin:0px;text-decoration:none">tenobreg@redhat.com</a></span></p><table border="0" style="box-sizing:border-box;color:rgb(0,0,0);font-family:overpass,sans-serif;font-size:medium"><tbody style="box-sizing:border-box"><tr style="box-sizing:border-box"><td width="100px" style="box-sizing:border-box"><a href="https://red.ht/sig" style="box-sizing:border-box"><img width="90" height="auto" style="box-sizing: border-box;" src="https://www.redhat.com/files/brand/email/sig-redhat.png"></a></td><td class="inbox-inbox-inbox-inbox-inbox-promo" style="box-sizing:border-box;font-size:10px"><div class="inbox-inbox-inbox-inbox-inbox-promo inbox-inbox-inbox-inbox-inbox-promo-1" style="box-sizing:border-box"><a href="https://redhat.com/trusted" style="box-sizing:border-box;text-decoration:none;color:rgb(204,0,0);font-weight:bold">TRIED. TESTED. TRUSTED.</a></div></td></tr></tbody></table><span style="color:rgb(153,153,153);font-family:Overpass,"Helvetica Neue",Helvetica,Arial,"Lucida Grande",sans-serif;font-size:12px;font-weight:600"> Red Hat é reconhecida entre as melhores empresas para trabalhar no Brasil pelo </span><span style="margin:0px;padding:0px;border:0px;font-weight:700;font-size:12px;font-family:Overpass,"Helvetica Neue",Helvetica,Arial,"Lucida Grande",sans-serif;vertical-align:baseline;color:rgb(153,153,153)">Great Place to Work</span><span style="color:rgb(153,153,153);font-family:Overpass,"Helvetica Neue",Helvetica,Arial,"Lucida Grande",sans-serif;font-size:12px;font-weight:600">.</span><br></div></div>