<div dir="ltr">Got it! Looks great!<br></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Jun 29, 2017 at 4:58 PM, Mike Perez <span dir="ltr"><<a href="mailto:thingee@gmail.com" target="_blank">thingee@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hey Melvin,<br>
<span class=""><br>
Ah yes, I should’ve mentioned earlier that this is totally a POC.<br>
There are lots missing, don’t worry! :)<br>
<br>
</span>—<br>
<span class="HOEnZb"><font color="#888888">Mike Perez<br>
</font></span><span class="im HOEnZb"><br>
On June 29, 2017 at 13:47:14, Melvin Hillsman (<a href="mailto:mrhillsman@gmail.com">mrhillsman@gmail.com</a>) wrote:<br>
> +1<br>
><br>
> Did not have a chance to draft a message but thanks for ops mention.<br>
><br>
</span><span class="im HOEnZb">> On Jun 29, 2017 3:02 PM, "Amy Marrich" wrote:<br>
><br>
> > First off it looks really sleek and I love the look! A few thoughts though<br>
> > and I do realize it's just a mock up:<br>
> ><br>
> > 1) We have Sponsor just to pick one but don't have<br>
> > Operators/Administrators and their feedback is a major contribution so<br>
> > please don't leave them out.<br>
> > 2) I would list the contributor types in alphabetical order that way no<br>
> > group feels slighted, you can't help it if Use Cases are last it's just<br>
> > that they start with a U vs Code which is a C.<br>
> > 3) What if you would like to contribute in multiple ways?<br>
> ><br>
> > Resources are definitely still underdevelopment there but are they meant<br>
> > to be broad applicable to all resources with more specialized one's visible<br>
> > when you click on how you'd like to contribute?<br>
> ><br>
> > Amy (spotz)<br>
> ><br>
</span><div class="HOEnZb"><div class="h5">> > On Thu, Jun 29, 2017 at 2:03 PM, Mike Perez wrote:<br>
> ><br>
> >> Hello all,<br>
> >><br>
> >> Wes has just took my ugly mock up of the contributor portal idea and<br>
> >> came up with this [1].<br>
> >><br>
> >> Here’s what he said:<br>
> >><br>
> >> "The idea is to help get potential contributors to the right place,<br>
> >> using the outline Mike put together. Rather than sending people to a<br>
> >> different page for each contribution type, users would be able to see<br>
> >> what options are available all on this page. We’d send them to any<br>
> >> necessary page(s) once they’ve gone through this quasi-wizard. Is this<br>
> >> along the lines of what you were thinking? page 2 shows the view once<br>
> >> you’ve clicked “Code” on page 1 (just in case that wasn’t super<br>
> >> obvious) Thanks!”<br>
> >><br>
> >> What do you all think? This does change things a bit of instead of the<br>
> >> landing page being more obvious of a resource of links, it’s both for<br>
> >> new and current contributors. Current contributors would hopefully be<br>
> >> able to see the resource links below.<br>
> >><br>
> >> Keep in mind that we will be working in the “Top 5 requested help” and<br>
> >> as suggested by Clark, an option of “I don’t know where I want to<br>
> >> start, but I want to help” kind of option. This would direct people to<br>
> >> resources such as Upstream University, mentor program, low hanging<br>
> >> fruit, that release priority idea I talked about earlier, etc.<br>
> >><br>
> >> Personally I like it!<br>
> >><br>
> >><br>
> >> [1] - <a href="https://www.dropbox.com/s/3q172qwfkik1ysd/contributor-port" rel="noreferrer" target="_blank">https://www.dropbox.com/s/<wbr>3q172qwfkik1ysd/contributor-<wbr>port</a><br>
> >> al.pdf?dl=0<br>
> >><br>
> >> —<br>
> >> Mike Perez<br>
> >><br>
> >> On June 27, 2017 at 13:48:36, Mike Perez (<a href="mailto:thingee@gmail.com">thingee@gmail.com</a>) wrote:<br>
> >> > Hello all,<br>
> >> ><br>
> >> > Every month we have people asking on IRC or the dev mailing list having<br>
> >> interest in working<br>
> >> > on OpenStack, and sometimes they're given different answers from<br>
> >> people, or worse,<br>
> >> > no answer at all.<br>
> >> ><br>
> >> > Suggestion: lets work our efforts together to create some common<br>
> >> documentation so that<br>
> >> > all teams in OpenStack can benefit.<br>
> >> ><br>
> >> > First it’s important to note that we’re not just talking about code<br>
> >> projects here. OpenStack<br>
> >> > contributions come in many forms such as running meet ups, identifying<br>
> >> use cases (product<br>
> >> > working group), documentation, testing, etc. We want to make sure those<br>
> >> potential contributors<br>
> >> > feel welcomed too!<br>
> >> ><br>
> >> > What is common documentation? Things like setting up Git, the many<br>
> >> accounts you need<br>
> >> > to setup to contribute (gerrit, launchpad, OpenStack foundation<br>
> >> account). Not all<br>
> >> > teams will use some common documentation, but the point is one or more<br>
> >> projects will use<br>
> >> > them. Having the common documentation worked on by various projects<br>
> >> will better help<br>
> >> > prevent duplicated efforts, inconsistent documentation, and hopefully<br>
> >> just more<br>
> >> > accurate information.<br>
> >> ><br>
> >> > A team might use special tools to do their work. These can also be<br>
> >> integrated in this idea<br>
> >> > as well.<br>
> >> ><br>
> >> > Once we have common documentation we can have something like:<br>
> >> > 1. Choose your own adventure: I want to contribute by code<br>
> >> > 2. What service type are you interested in? (Database, Block storage,<br>
> >> compute)<br>
> >> > 3. Here’s step-by-step common documentation to setting up Git, IRC,<br>
> >> Mailing Lists,<br>
> >> > Accounts, etc.<br>
> >> > 4. A service type project might choose to also include additional<br>
> >> documentation in that<br>
> >> > flow for special tools, etc.<br>
> >> ><br>
> >> > Important things to note in this flow:<br>
> >> > * How do you want to contribute?<br>
> >> > * Here are **clear** names that identify the team. Not code names like<br>
> >> Cloud Kitty, Cinder,<br>
> >> > etc.<br>
> >> > * The documentation should really aim to not be daunting:<br>
> >> > * Someone should be able to glance at it and feel like they can finish<br>
> >> things in five minutes.<br>
> >> > Not be yet another tab left in their browser that they’ll eventually<br>
> >> forget about<br>
> >> > * No wall of text!<br>
> >> > * Use screen shots<br>
> >> > * Avoid covering every issue you could hit along the way.<br>
> >> ><br>
> >> > ## Examples of More Simple Documentation<br>
> >> > I worked on some documentation for the Upstream University preparation<br>
> >> that has received<br>
> >> > excellent feedback meet close to these suggestions:<br>
> >> > * IRC [1]<br>
> >> > * Git [2]<br>
> >> > * Account Setup [3]<br>
> >> ><br>
> >> > ## 500 Feet Birds Eye view<br>
> >> > There will be a Contributor landing page on the <a href="http://openstack.org" rel="noreferrer" target="_blank">openstack.org</a> website.<br>
> >> Existing contributors<br>
> >> > will find reference links to quickly jump to things. New contributors<br>
> >> will find a banner<br>
> >> > at the top of the page to direct them to the choose your own adventure<br>
> >> to contributing to<br>
> >> > OpenStack, with ordered documentation flow that reuses existing<br>
> >> documentation when<br>
> >> > necessary. Picture also a progress bar somewhere to show how close you<br>
> >> are to being ready<br>
> >> > to contribute to whatever team. Of course there are a lot of other<br>
> >> fancy things we can come<br>
> >> > up with, but I think getting something up as an initial pass would be<br>
> >> better than what we<br>
> >> > have today.<br>
> >> ><br>
> >> > Here's an example of what the sections/chapters could look like:<br>
> >> ><br>
> >> > - Code<br>
> >> > * Volumes (Cinder)<br>
> >> > * IRC<br>
> >> > * Git<br>
> >> > * Account Setup<br>
> >> > * Generating Configs<br>
> >> > * Compute (Nova)<br>
> >> > * IRC<br>
> >> > * Git<br>
> >> > * Account Setup<br>
> >> > * Something about hypervisors (matrix?)<br>
> >> > - Use Cases<br>
> >> > * Products (Product working group)<br>
> >> > * IRC<br>
> >> > * Git<br>
> >> > * Use Case format<br>
> >> ><br>
> >> > There are some rough mock up ideas [4]. Probably Sphinx will be fine<br>
> >> for this. Potentially<br>
> >> > we could use this content for conference lunch and learns, upstream<br>
> >> university, and<br>
> >> > the on-boarding events at the Forum. What do you all think?<br>
> >> ><br>
> >> > [1] - <a href="http://docs.openstack.org/upstream-training/irc.html" rel="noreferrer" target="_blank">http://docs.openstack.org/<wbr>upstream-training/irc.html</a><br>
> >> > [2] - <a href="http://docs.openstack.org/upstream-training/git.html" rel="noreferrer" target="_blank">http://docs.openstack.org/<wbr>upstream-training/git.html</a><br>
> >> > [3] - <a href="http://docs.openstack.org/upstream-training/accounts.html" rel="noreferrer" target="_blank">http://docs.openstack.org/<wbr>upstream-training/accounts.<wbr>html</a><br>
> >> > [4] - <a href="https://www.dropbox.com/s/o46xh1cp0sv0045/OpenStack%20contri" rel="noreferrer" target="_blank">https://www.dropbox.com/s/<wbr>o46xh1cp0sv0045/OpenStack%<wbr>20contri</a><br>
> >> butor%20portal.pdf?dl=0<br>
> >><br>
> >> ______________________________<wbr>_________________<br>
> >> User-committee mailing list<br>
> >> <a href="mailto:User-committee@lists.openstack.org">User-committee@lists.<wbr>openstack.org</a><br>
> >> <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/user-committee" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/user-<wbr>committee</a><br>
> >><br>
> ><br>
> ><br>
> > ______________________________<wbr>_________________<br>
> > User-committee mailing list<br>
> > <a href="mailto:User-committee@lists.openstack.org">User-committee@lists.<wbr>openstack.org</a><br>
> > <a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/user-committee" rel="noreferrer" target="_blank">http://lists.openstack.org/<wbr>cgi-bin/mailman/listinfo/user-<wbr>committee</a><br>
> ><br>
> ><br>
><br>
</div></div></blockquote></div><br><br clear="all"><br>-- <br><div class="gmail_signature" data-smartmail="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><span style="font-size:small">-- </span><br style="font-size:small"><div style="font-size:small"><div dir="ltr"><div dir="ltr">Kind regards,<br><br>Melvin Hillsman</div><div dir="ltr"><a href="mailto:mrhillsman@gmail.com" style="color:rgb(17,85,204)" target="_blank">mrhillsman@gmail.com</a><br>mobile: (832) 264-2646<br><br>Learner | Ideation | Belief | Responsibility | Command</div></div></div></div></div></div></div></div></div>
</div>