Catarina,<div><br></div><div>This Jam is incredibly awesome! I'm actually a week or two away from launching a website based on this exact problem.</div><div><br></div><div>I'd like to discuss organizing a parallel event in Colorado Springs or Denver. It's not exactly a hotbed, but there are several entities out here already like Sparkfun. This might actually be a perfect opportunity to get some basic organization among the open source front range community.</div>
<div><br></div><div>Good stuff. It's exciting to see everyone thinking in the same direction.</div><div>-Matt<br><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<br>
<br>
----------------------------------------------------------------------<br>
<br>
Message: 1<br>
Date: Thu, 7 Mar 2013 12:04:15 -0500<br>
From: Catarina Mota <<a href="mailto:catarina@openmaterials.org">catarina@openmaterials.org</a>><br>
To: The Open Source Hardware Association Discussion List<br>
        <<a href="mailto:discuss@lists.oshwa.org">discuss@lists.oshwa.org</a>><br>
Subject: Re: [Discuss] Google Doc for describing best practices.<br>
Message-ID:<br>
        <<a href="mailto:CAH-asVbvjVqvJJnU9noxro1fsvqunFCjhhPp1RecwuLa4BsYoA@mail.gmail.com">CAH-asVbvjVqvJJnU9noxro1fsvqunFCjhhPp1RecwuLa4BsYoA@mail.gmail.com</a>><br>
Content-Type: text/plain; charset="iso-8859-1"<br>
<br>
Hi all,<br>
<br>
We're organizing a hackathon to arrive at some OSHW documentation best<br>
practices and tools: <a href="http://www.opensourcewarehouse.org" target="_blank">http://www.opensourcewarehouse.org</a><br>
<br>
It all started a few months ago with a few causal conversations with open<br>
source hardware developers that were concerned with the fact that weren't<br>
getting enough public contributions to their projects and also that they<br>
sometimes found it difficult to build on top of other's projects. Both were<br>
related to insufficient, deficient or hard to interpret documentation. So<br>
this got us thinking about how can we improve documentation to make open<br>
source hardware more accessible to all and to drive more contributions to<br>
projects. This is the initial list of challenges we identified (to build<br>
upon by the community):<br>
<a href="http://www.opensourcewarehouse.org/problem-statement/" target="_blank">http://www.opensourcewarehouse.org/problem-statement/</a><br>
<br>
And here's an initial taxonomy (to be refined or abandoned at the<br>
hackathon):<br>
<a href="https://docs.google.com/spreadsheet/ccc?key=0AkNG-lv1ELQvdHViNEdtVHp4dHRWOU8tcDNSbXROY3c&usp=sharing" target="_blank">https://docs.google.com/spreadsheet/ccc?key=0AkNG-lv1ELQvdHViNEdtVHp4dHRWOU8tcDNSbXROY3c&usp=sharing</a><br>

<br>
Since this a huge challenge and one that concerns the entire community, we<br>
figured the best way to approach it would be to start with a hackathon to<br>
identify the problems and find ways to tackle them.<br>
<br>
We hope that some of the outcomes will be:<br>
<br>
- A set of best practices for open source hardware documentation, including<br>
a taxonomy and a check list.<br>
- A set of recommended software tools for generating and sharing<br>
documentation - this may either be the adoption of something that is<br>
already out there or, more likely, a mashup of existing platforms<br>
- A way to identify which parts of a project are open source and have<br>
documentation<br>
- The seed for an OSHW repository or a search engine<br>
<br>
I hope many of you can join us and bring your ideas and insights to the<br>
table. More details coming up on a separate email.<br>
<br>
Cheers,<br>
Catarina<br>
<br></blockquote></div></div>