<html dir="ltr"><head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
</head>
<body style="text-align:left; direction:ltr;"><div>On Wed, 2019-04-10 at 11:45 +0100, Stephen Finucane wrote:</div><blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex"><div>[Top posting]</div><div><br></div><div>Petr (Kovar) has kindly put me in touch with folks within Red Hat who have worked on this in the past for other projects. They're able to help with getting the submission out the door and have pointed to Gnome's submission as a good example of what we need to do here:</div><div><br></div><div><a href="https://wiki.gnome.org/Outreach/SeasonofDocs">https://wiki.gnome.org/Outreach/SeasonofDocs</a></div><div><br></div><div>Based of that, I guess the next steps are figuring out what projects need the most help and putting together a list of ideas that we can submit.</div><div><br></div><div>I can only really speak for nova and oslo. For nova, I'd like to see us better align with the documentation style used in Django, which is described in the below article:</div><div><br></div><div><a href="https://jacobian.org/2009/nov/10/what-to-write/">https://jacobian.org/2009/nov/10/what-to-write/</a></div><div><br></div><div>The documentation structure we use doesn't allow us to map to this directly but I do think there are some easy gains to be made:</div><div><br></div><ul><li>More clearly delineate between admin-facing (/admin) and user-facing (/user) docs</li><li>Expand the how-to docs we have to better explain common user and admin operations, such as rebooting instances, rebuilding, attaching interfaces, etc.</li></ul><div><br></div><div>On top of that, there are some general cleanup things that need to happen and just haven't.</div><div><br></div><ul><li>[Technical] Audit our reference guide, which explains concepts like cells v2, to see if these make sense to someone who's not in the trenches</li><li>Generally examine the structure of the docs to see how easy it is to find stuff (fwiw, I struggle to find things without Google so this is probably a bad sign)</li></ul><div><br></div><div>For oslo, I think our issue is less about documentation and more about marketing (very few people outside of OpenStack know that reno is a thing, for example, or that oslo.config exists and is as powerful as it is) so there's nothing I'd really submit here. I'm willing to debate that though, if someone disagrees.</div><div><br></div><div>Does anyone else have anything they'd like to get help with? If so, please let me know (here or on IRC) and we can feed that into the process.</div><div><br></div><div>Stephen</div></blockquote><div><br></div><div>Just to close this off, we never got to finish the application for this. It was quite involved, as promised, and Summit/PTG work took priority.</div><div><br></div><div>Hopefully we'll be able to try again next year. Thanks to all who provided suggestions for things to work on.</div><div><br></div><div>Stephen</div><div><br></div><blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex"><div>On Thu, 2019-03-21 at 10:07 +0000, Alexandra Settle wrote:</div><blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex">
<p><br>
</p>
<div class="moz-cite-prefix">On 21/03/2019 01:58, Kendall Nelson wrote:<br>
</div>
<blockquote type="cite" cite="mid:CAJ6yrQhGOxF7umhP1Z4Hur0777ChB2dLXApRLVikCTXy76SRpw@mail.gmail.com" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex">
<div dir="ltr">We've only been selected on time previously I think? The application process was pretty involved from what I recall. I will dig around and see if I can find anything from our last application and send it over if I discover anything.
<div><br>
</div>
<div>Happy to try to help with the application too if you want an extra set of eyes/hands.<br>
</div>
</div>
</blockquote>
<p>Ditto. I love these applications and Outreachy was really successful! (well, sorta, long story)<br>
</p>
<blockquote type="cite" cite="mid:CAJ6yrQhGOxF7umhP1Z4Hur0777ChB2dLXApRLVikCTXy76SRpw@mail.gmail.com" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex">
<div dir="ltr">
<div>
<div><br>
</div>
<div>-Kendall (diablo_rojo)</div>
</div>
</div>
<br>
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">On Wed, Mar 20, 2019 at 2:51 AM Stephen Finucane <<a href="mailto:sfinucan@redhat.com" moz-do-not-send="true">sfinucan@redhat.com</a>> wrote:<br>
</div>
<blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex">
<div style="text-align:left;direction:ltr">
<div>On Tue, 2019-03-12 at 14:42 -0700, Kendall Nelson wrote:</div>
<blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex">
<div dir="ltr">I think it would be a great idea if we can find someone to be our coordinator. In the past when I've helped out with the Google Summer of Code, the application has been a fair bit of work, but maybe this one is different? I haven't looked yet.
I can try to help support whoever wants to coordinate this, but I don't have time to be the primary point of contact.
<div><br>
</div>
<div>-Kendall (diablo_rojo)</div>
</div>
</blockquote>
<div><br>
</div>
</div>
<div style="text-align:left;direction:ltr">
<div>This sounds like something the docs team (and me specifically) could take point on. I'm happy to look into what's required and reach out to people as necessary. Is there anything documented regarding the previous Summer of Code applications though?</div>
</div>
<div style="text-align:left;direction:ltr">
<div><br>
</div>
<div>Stephen</div>
</div>
<div style="text-align:left;direction:ltr">
<div><br>
</div>
<blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex">
<div class="gmail_quote">
<div dir="ltr" class="gmail_attr">On Mon, Mar 11, 2019 at 9:30 AM Mohammed Naser <<a href="mailto:mnaser@vexxhost.com" target="_blank" moz-do-not-send="true">mnaser@vexxhost.com</a>> wrote:<br>
</div>
<blockquote type="cite" style="margin:0 0 0 .8ex; border-left:2px #729fcf solid;padding-left:1ex">
Hi there:<br>
<br>
It seems like Google has come up with a new somewhat-GSoC-like idea<br>
but focused on documentation. I think it could be a good opportunity<br>
for the documentation team (or any specific team actually, coordinated<br>
with docs) to be part of this.<br>
<br>
<a href="https://opensource.googleblog.com/2019/03/introducing-season-of-docs.html" rel="noreferrer" target="_blank" moz-do-not-send="true">https://opensource.googleblog.com/2019/03/introducing-season-of-docs.html</a><br>
<br>
I'm not sure if the team has the amount of resources, but it seems<br>
they should be able to apply to this. Does this seem like something<br>
that might help the team more (or perhaps a specific project,<br>
coordinating with the docs team) to apply for this?<br>
<br>
Thanks,<br>
Mohammed</blockquote></div></blockquote></div></blockquote></div></blockquote></blockquote>
</blockquote></body></html>