<div dir="ltr"><div class="gmail_extra"><div class="gmail_quote">On 14 February 2014 07:06, Victoria Martínez de la Cruz <span dir="ltr"><<a href="mailto:victoria@vmartinezdelacruz.com" target="_blank">victoria@vmartinezdelacruz.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div dir="ltr">Hi all,<div><div><br></div><div>I think we should separate between mentoring efforts and documentation.</div>
<div><br></div><div>For the first one, is true that there are always tons of tasks to do but sometimes a beginner won't find them because they are not familiar with the workflow neither with the community. People that is not involved with open-source just doesn't know where to start when reaching to an organization of this kind. So, having someone to ask about this is usually a great help. That is something OpenHatch is intended to solve.</div>


<div><br></div><div>I must say that OpenHatch is not time consuming and helped several people to join OpenStack and start contributing to it. And that is great :)</div><div><br></div><div>Another thing we tried last year is #openstack-101, a channel for new contributors where they are free to ask any doubt they could have. I'm happy to say this worked as a hub between newcomers and the community and that lots of people have been able to start working with us.</div>


<div><br></div><div>About documentation, I agree that it could be quite overwhelming the first time, but that is how complex our organization is. The thing is... we get used to that.</div><div><br></div><div>Perhaps we could ask new contributors what they would like to find in the 'How to contribute' wiki page and refine it to make it easier for new people (I volunteer for that!).</div>


<div><br></div><div>Finally, I wanted to mention that mentoring is great. I still have many things to learn, but I have been able to guide people with their first steps in the community and is cool to see how a little effort like that mean, later in time, great contributions.</div>


<div><br></div><div>Thanks all for the feedback,</div><div><br></div><div>Victoria</div><div><br></div></div></div></blockquote><div><br></div><div>It has probably been mentioned before and I missed it but, where can people find these mentors you talk about? This should be mentioned in pages like:</div>
<div><a href="https://wiki.openstack.org/wiki/HowToContribute">https://wiki.openstack.org/wiki/HowToContribute</a><br></div><div><a href="https://wiki.openstack.org/wiki/DevQuickstart">https://wiki.openstack.org/wiki/DevQuickstart</a><br>
</div><div><a href="https://swiftstack.com/blog/2013/02/12/swift-for-new-contributors/">https://swiftstack.com/blog/2013/02/12/swift-for-new-contributors/</a><br></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div dir="ltr"><div><div></div></div></div><div class="gmail_extra"><br><br><div class="gmail_quote">2014-02-13 23:46 GMT-03:00 Luis de Bethencourt <span dir="ltr"><<a href="mailto:luis@debethencourt.com" target="_blank">luis@debethencourt.com</a>></span>:<br>


<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div><div class="h5"><div dir="ltr"><div class="gmail_extra">
<div class="gmail_quote"><div>On 13 February 2014 21:09, Jeremy Stanley <span dir="ltr"><<a href="mailto:fungi@yuggoth.org" target="_blank">fungi@yuggoth.org</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
On 2014-02-12 14:42:17 -0600 (-0600), Dolph Mathews wrote:<br>
[...]<br>
> There's a lot of such scenarios where new contributors can<br>
> quickly find things to contribute, or at lest provide incredibly<br>
> valuable feedback to the project in the form of reviews!<br>
[...]<br>
<br>
I heartily second the suggestion. The biggest and best thing I did<br>
as a new contributor was to start reviewing changes first thing. An<br>
initial contributor, if they have any aptitude for software<br>
development at all, will be able to tell a ton about our development<br>
community by how it interacts through code review. The test-centric<br>
methodology, style guidelines and general level of<br>
acceptance/tolerance for various things become immediately apparent.<br>
You also get to test your understanding of the source by watching<br>
all the mistakes other reviewers find that you missed in your<br>
reviewing. Refine and repeat.<br>
<br>
Getting a couple of very simple changes in right away also helps you<br>
pick up the workflow and toolset, but reviewing others changes is a<br>
huge boon to both the project and the would-be contributors doing<br>
the reviewing... much more so than correcting a handful of<br>
typographical errors.<br>
<span><font color="#888888">--<br>
Jeremy Stanley<br></font></span></blockquote><div><br></div><div><br></div></div><div>That is a very good idea Jeremy.</div><div><br></div><div>I started learning and contributing to OpenStack yesterday. I have been writing down all the things I do, read and discover. Planning to blog about and share it. I think it would be valuable to show how to contribute and learn the project from the point of view of a novice to it.</div>



<div><br></div><div>Cheers,</div><div>Luis</div></div></div><div class="gmail_extra"><br></div></div>
<br></div></div><div class="">_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org" target="_blank">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
<br></div></blockquote></div><br></div>
<br>_______________________________________________<br>
OpenStack-dev mailing list<br>
<a href="mailto:OpenStack-dev@lists.openstack.org">OpenStack-dev@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev</a><br>
<br></blockquote></div><br></div></div>