<div dir="ltr">Back on April our Community was invited to take part of <font size="2">the </font><font size="2">Open Source Survey 2017</font>.<br>
          <p class="gmail-alt-lead gmail-text-center gmail-text-gray gmail-col-md-8 gmail-mx-auto gmail-mb-4 gmail-position-relative">"The Open Source Survey is an open data project by GitHub and
 collaborators from academia, industry, and the broader open source 
community."</p><p class="gmail-alt-lead gmail-text-center gmail-text-gray gmail-col-md-8 gmail-mx-auto gmail-mb-4 gmail-position-relative">Survey data available for download here: <a href="http://opensourcesurvey.org/2017/">http://opensourcesurvey.org/2017/</a></p>
          <p>This survey was designed by GitHub with valuable input from
 the research and open source communities.</p><p>I copy and pasted the following findings about the importance of documentation:<br></p><h3>Documentation is highly valued, but often overlooked</h3>
          <p>Documentation helps orient newcomers: how to use a project,
 how to contribute back, the terms of use and contribution, and the 
standards of conduct in a community. Improving that documentation is an 
impactful way to contribute back to open source.</p>
            <ul><li>Incomplete or outdated documentation is a pervasive 
problem, observed by 93% of respondents, yet 60% of contributors say 
they rarely or never contribute to documentation. <strong>When you run into documentation issues, help a maintainer out and open a pull request that improves them.</strong></li><li>Many people participate in open source on the job, where confidence in the terms of use is critical. Unsurprisingly, <strong>licenses are by far the most important type of documentation to both users and contributors:</strong>
 64% say an open source license is very important in deciding whether to
 use a project, and 67% say it is very important in deciding whether to 
contribute.</li><li><strong>Documentation helps create inclusive communities.</strong>
 Documentation that clearly explains a project's processes, such as 
contributing guides and codes of conduct, is valued more by groups that 
are underrepresented in open source, like women.</li><li>Nearly a quarter of the open source community reads and writes English less than ‘very well.’ <strong>When
 communicating on a project, use clear and accessible language for 
people who didn’t grow up speaking English, or read less-than-fluently.</strong></li></ul>

          
            
              
                <p>Regards,<br></p><div>-- <br><div class="gmail_signature"><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div><div dir="ltr"><div>Laura V.<br><font color="#ff00ff"><b>
I&D SomosAZUCAR.Org</b></font></div><div><div style="color:rgb(136,136,136);font-size:12.8px"><font size="2"><span style="color:rgb(102,102,102);font-family:"helvetica neue",helvetica,arial,sans-serif"><br>“Solo la tecnología libre nos hará libres.” </span></font></div><div style="color:rgb(136,136,136);font-size:12.8px"><font size="2"><span style="color:rgb(102,102,102);font-family:"helvetica neue",helvetica,arial,sans-serif">~ L. Victoria</span></font><br><br></div><div style="color:rgb(136,136,136);font-size:12.8px">Happy Learning!<br>#LearningByDoing</div><div style="color:rgb(136,136,136);font-size:12.8px">#Projects4good</div><div style="color:rgb(136,136,136);font-size:12.8px">#IDesignATSugarLabs<br></div><div style="color:rgb(136,136,136);font-size:12.8px">#WeCanDoBetter</div></div></div></div></div></div></div></div></div></div></div></div>
</div></div>