<div dir="ltr">The Open Source Hardware Documentation Jam attempted to come up with a standardized set of metadata, or at least v0.1 of standard metadata<div><a href="http://blog.opensourceecology.org/2013/06/open-source-hardware-documentation-jam-a-report/">http://blog.opensourceecology.org/2013/06/open-source-hardware-documentation-jam-a-report/</a><br></div><div><br></div><div>"<span style="color:rgb(51,51,51);font-family:'Lucida Grande','Lucida Sans Unicode',Verdana,Arial,sans-serif;font-size:12px;line-height:1.5em">Using a stack of Post-It notes, the taxonomy group delineated essential metatags and metadescriptors to be incorporated into  documentation and organized them on the wall:</span></div><ul style="font-size:12px;line-height:1.5em;margin:1.2em 0px 1.2em 2em;padding:0px;color:rgb(51,51,51);font-family:'Lucida Grande','Lucida Sans Unicode',Verdana,Arial,sans-serif"><li>OSHW – The tags that identifies the entire project as open source hardware</li><li>Entity – The person or organization responsible for the project</li><li>Project Name – Something unique that identifies the specific project</li><li>Version – An alpha-numeric code that increments at milestones</li><li>Completion Status – The general maturity level of the project</li><li>Version Date – Last time the version number changed</li><li>Terms of Use – Any terms of use or licensing compatible with the latest version of the open source hardware definition</li><li>Summary – The project pitch – short (140 characters?)</li><li>Keywords – A comma separated list of synonyms – tags for search engine optimization</li><li>Description – The detailed description of the project</li><li>Predecessors – This project descended from…</li><li>Content Location – A URL to the main project repository</li></ul><p style="font-size:12px;line-height:1.5em;margin:1.2em 0px;color:rgb(51,51,51);font-family:'Lucida Grande','Lucida Sans Unicode',Verdana,Arial,sans-serif">Beyond these, group members also targeted other metadescriptors that would be helpful for turning up the right project:</p><ul style="font-size:12px;line-height:1.5em;margin:1.2em 0px 1.2em 2em;padding:0px;color:rgb(51,51,51);font-family:'Lucida Grande','Lucida Sans Unicode',Verdana,Arial,sans-serif"><li>Difficulty Level</li><li>Author / Contributors</li><li>Required Tools</li><li>Approximate Cost</li><li>Required Space</li></ul><p style="font-size:12px;line-height:1.5em;margin:1.2em 0px;color:rgb(51,51,51);font-family:'Lucida Grande','Lucida Sans Unicode',Verdana,Arial,sans-serif">The biggest little Post-It ever turned out to be the simple tag “OSHW” (for Open Source Hardware). Marcin explains:</p><blockquote style="margin:0px 20px;padding:0px 20px;border-left-width:4px;border-left-style:solid;border-left-color:rgb(232,231,208);font-size:0.9em;color:rgb(51,51,51);font-family:'Lucida Grande','Lucida Sans Unicode',Verdana,Arial,sans-serif"><p style="font-size:1em;line-height:1.5em;margin:1.2em 0px">We took a picture of that little Post-It, and we said, “This is the result of the entire jam!” That is to say – if only any <em>open source</em> hardware project identified itself as such – that would make life much easier for others"</p></blockquote></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Sat, Sep 6, 2014 at 3:01 PM, Bryan Bishop <span dir="ltr"><<a href="mailto:kanzure@gmail.com" target="_blank">kanzure@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><span class=""><div class="gmail_quote">On Sat, Sep 6, 2014 at 12:00 PM, Matt Maier <span dir="ltr"><<a href="mailto:blueback09@gmail.com" target="_blank">blueback09@gmail.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">There is also ThingTracker, which has been around for a while and is not centralized <a href="http://thingtracker.net/" target="_blank">http://thingtracker.net/</a></div><div class="gmail_extra"></div></blockquote></div><br></span>Similar in that spirit was this proposal: <a href="http://gnusha.org/skdb/package_spec.html" target="_blank">http://gnusha.org/skdb/package_spec.html</a></div><div class="gmail_extra"><br></div><div class="gmail_extra">However, I think the primary problem with these proposals is one of incentives-- how do you convince everyone else to start being package maintainers, or if you can't do that, then are you willing to clobber everyone's work into packages on your own? Most of the time there aren't enough files given anyway and there's not much to package up. And even if there is, then you're left with the problem of limited metadata- which is only a problem depending on which packager you're talking with ("Well, I only use packages that specify ports of connectivity on each piece of hardware", "Oh, I prefer packages that have automated instructions for assembly and creation by pick n place, cnc, etc.")..I believe the exact analogy isn't going to transfer from software, and any useful solution will end up looking pretty alien in the end.<br><br>- Bryan<br><a href="http://heybryan.org/" target="_blank">http://heybryan.org/</a><br><a href="tel:1%20512%20203%200507" value="+15122030507" target="_blank">1 512 203 0507</a>
</div></div>
<br>_______________________________________________<br>
discuss mailing list<br>
<a href="mailto:discuss@lists.oshwa.org">discuss@lists.oshwa.org</a><br>
<a href="http://lists.oshwa.org/listinfo/discuss" target="_blank">http://lists.oshwa.org/listinfo/discuss</a><br>
<br></blockquote></div><br></div>