<div dir="ltr">First off it looks really sleek and I love the look! A few thoughts though and I do realize it's just a mock up:<div><br></div><div>1) We have Sponsor just to pick one but don't have Operators/Administrators and their feedback is a major contribution so please don't leave them out.</div><div>2) I would list the contributor types in alphabetical order that way no group feels slighted, you can't help it if Use Cases are last it's just that they start with a U vs Code which is a C.</div><div>3) What if you would like to contribute in multiple ways?</div><div><br></div><div>Resources are definitely still underdevelopment there but are they meant to be broad applicable to all resources with more specialized one's visible when you click on how you'd like to contribute?</div><div><br></div><div>Amy (spotz)</div></div><div class="gmail_extra"><br><div class="gmail_quote">On Thu, Jun 29, 2017 at 2:03 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">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-portal.pdf?dl=0" rel="noreferrer" target="_blank">https://www.dropbox.com/s/<wbr>3q172qwfkik1ysd/contributor-<wbr>portal.pdf?dl=0</a><br>
<br>
—<br>
<span class="HOEnZb"><font color="#888888">Mike Perez<br>
</font></span><div class="HOEnZb"><div class="h5"><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 interest in working<br>
> on OpenStack, and sometimes they're given different answers from people, or worse,<br>
> no answer at all.<br>
><br>
> Suggestion: lets work our efforts together to create some common 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 projects here. OpenStack<br>
> contributions come in many forms such as running meet ups, identifying use cases (product<br>
> working group), documentation, testing, etc. We want to make sure those potential contributors<br>
> feel welcomed too!<br>
><br>
> What is common documentation? Things like setting up Git, the many accounts you need<br>
> to setup to contribute (gerrit, launchpad, OpenStack foundation account). Not all<br>
> teams will use some common documentation, but the point is one or more projects will use<br>
> them. Having the common documentation worked on by various projects will better help<br>
> prevent duplicated efforts, inconsistent documentation, and hopefully just more<br>
> accurate information.<br>
><br>
> A team might use special tools to do their work. These can also be 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, compute)<br>
> 3. Here’s step-by-step common documentation to setting up Git, IRC, Mailing Lists,<br>
> Accounts, etc.<br>
> 4. A service type project might choose to also include additional 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 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 things in five minutes.<br>
> Not be yet another tab left in their browser that they’ll eventually 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 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. Existing contributors<br>
> will find reference links to quickly jump to things. New contributors will find a banner<br>
> at the top of the page to direct them to the choose your own adventure to contributing to<br>
> OpenStack, with ordered documentation flow that reuses existing documentation when<br>
> necessary. Picture also a progress bar somewhere to show how close you are to being ready<br>
> to contribute to whatever team. Of course there are a lot of other fancy things we can come<br>
> up with, but I think getting something up as an initial pass would be 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 for this. Potentially<br>
> we could use this content for conference lunch and learns, upstream 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%20contributor%20portal.pdf?dl=0" rel="noreferrer" target="_blank">https://www.dropbox.com/s/<wbr>o46xh1cp0sv0045/OpenStack%<wbr>20contributor%20portal.pdf?dl=<wbr>0</a><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>
</div></div></blockquote></div><br></div>