<div dir="ltr"><div><div>I know that Mario G√≥mez worked on a GitHub template for the Open Hardware Community here in El Salvador, which is what we use for our project. I had totally forgotten that I actually translated it into English! If you can't find a standarized layout for documentation elsewhere, perhaps this might help.<br><br>Here it is: <a href="https://github.com/dubsnipe/plantilla">https://github.com/dubsnipe/plantilla</a><br></div><br></div>Let us know if this works for you!<br></div><div class="gmail_extra"><br><div class="gmail_quote">On 30 March 2015 at 03:44, Antoine, as a contact of a free smallwindturbine project <span dir="ltr"><<a href="mailto:smallwindturbineproj.contactor@gmail.com" target="_blank">smallwindturbineproj.contactor@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><div>Hello Matt, Hello Javier, Hello all,<br></div>Thank you for your kind returns and thank you dear OSHWA for this list.<br></div><br><div>> Javier: "I am not sure about what Antoine is asking."<br></div><div>Let's retry. A template of URD, specific for open source hardware development, if this exist. <br>What I mean is : <br><ol><li>if the experience of writing such a document, shows that it leads to a specific way of writing an URD when it covers Open Source Hardware, then, it might be useful for OpenSource Hardware people to get access to this kind of template for their own development processes (when an URD could be helpful for their work).</li><li>if such a template document is designed and titled "URD template for Open Source Hardware", then, Open Source hardware people will be more confident to use it, compared with a document without any "for Open Source Hardware" mention.<br></li></ol><br></div><div>> Matt: "CERN might" .../... "I haven't heard of a template"<br></div><div>By my side also, I have not found yet such an URD specific for open hardware.<br></div><div>There are CERN URD template available, but for software, but not specific for Open or Free software, for example at <a href="http://lhcb-comp.web.cern.ch/lhcb-comp/Support/Documentation/Templates/URDTemplate.html" target="_blank">CERN LHcb web site / User Requirement Template</a> <br></div><div>Javier is the best who knows the right CERN music ... and we are lucky to get the chance to read you Javier ...<br></div><div><br></div><div>> Matt: "lists requirements" .../... "And there's more specific guidance"</div><div>Those pages are very useful, thank you OSHWA.<br>However, they do not really give specific "templates" for what could be called: normative standard documents for development product process stages - like sort of ISO documentation recommendations.<br>If OSHWA could suggest a list of available templates for the specific development process stages of open hardware things, then that might be a great "service" offered by OSHWA, to be added on the "Open Source Hardware Best Practices" in a new section called "templates of standard documents for open source hardware development process stages".<br></div><div>When bazaar if privileged, it might happen to "cathedralize" a bit the processes, using such a URD material, particularly, when external actors of an open hardware project, are invited to participate.<br><br></div><div>Thank you for your exchanges, thank you OSHWA for this list,<br><br></div><div>Freely,<br><br></div><div>Antoine<br></div></div><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><br><div class="gmail_quote">2015-03-25 18:37 GMT+01:00 Matt Maier <span dir="ltr"><<a href="mailto:blueback09@gmail.com" target="_blank">blueback09@gmail.com</a>></span>:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div>The open source hardware¬†definition lists requirements for a license to be considered "open source." <a href="http://www.oshwa.org/definition/" target="_blank">http://www.oshwa.org/definition/</a></div><div><br></div><div>And there's more specific guidance in this list <a href="http://www.oshwa.org/open-source-quick-reference-guide/" target="_blank">http://www.oshwa.org/open-source-quick-reference-guide/</a></div><div><br></div><div>I haven't heard of a template. I assume that's because the actual shape of a project's requirements will vary quite a bit. Also, it seems like the things necessary to qualify as open source are a bit different from "what does it do" which is what's in the requirements document. If you included "be open in these ways" in the requirements doc it would either imply that you're acquiring a whole process or that you're going beyond "what" and specifying "how." </div><div><br></div><div>It seems like that information wouldn't be in the requirements doc, but maybe I misunderstood the question(?)</div></div><div class="gmail_extra"><br><div class="gmail_quote"><div><div>On Wed, Mar 25, 2015 at 9:01 AM, Antoine, as a contact of a free smallwindturbine project <span dir="ltr"><<a href="mailto:smallwindturbineproj.contactor@gmail.com" target="_blank">smallwindturbineproj.contactor@gmail.com</a>></span> wrote:<br></div></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div><div dir="ltr"><div><div><div><div><div>Hi all,<br><br></div><div>1. thank you OSHWA for what you do<br></div><div>2. thank you OSHWA list members for your exchanges<br></div><div><br></div>3.<br>Do you know if there is somewhere a User Requirement Document (URD) standard Template, but including OpenHardware requirements ?<br></div><br>Maybe public organizations ike NASA, CERN, European Space Agency, or others, have sorts of templates for this kind of documents ?<br></div><br>If not, should we try to build one ? <br><br><div>4. thank you OSHWA for what you do<br></div><div>5. thank you OSHWA list members for your exchanges<br></div><div><br></div></div>Freely,<br><br></div>Antoine<br></div>
<br></div></div><span>_______________________________________________<br>
discuss mailing list<br>
<a href="mailto:discuss@lists.oshwa.org" target="_blank">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></span></blockquote></div><br></div>
<br>_______________________________________________<br>
discuss mailing list<br>
<a href="mailto:discuss@lists.oshwa.org" target="_blank">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>
</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>