<div dir="ltr"><div><div><div><div><div>I would say both.<br></div><br></div>Personally I always liked the idea of software repositories like PyPI (<a href="https://pypi.python.org/pypi" target="_blank">https://pypi.python.org/pypi</a>). Websites like Thingiverse, and Upverter are great but are more on focused on the design files than the whole picture of the OSHW. </div>
<div><br></div><div>The reason why we (as the OH community in El Salvador) were so interested on the good practices document is that provides a very good "framework" that can be easily translated to a template that anyone (independent of the publishing platform) could use as a base for their projects. I think that Wikis as a collaborative documentation tool are great, but you always have to "set up" a platform for using them. Git provides both source-versioning and simplicity (you can use text files as the documentation or the last snapshot from your wiki in HTML format) with the plus that you can track the evolution of your project and share with the community over GitHub.<br>
</div><br></div>Yesterday I was talking with Emilio about an idea that they have for setting up a "open source hardware repository" where the people from the local Universities could upload their proyects and they are thinking to use the template that we developed as the "standard" to share the info over there. The idea is that at the end is going to be something like PyPI but for OSHW projects. <br>
<br></div><div>Regards,<br></div>Mario.<br><div><div><div><div><div><div><div><br><br></div></div></div></div></div></div></div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Oct 16, 2013 at 3:12 AM, FREE SMALL WIND TURBINE PROJECT PEOPLE <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>Hi Mario,<div class="im"><br>> The idea is that with this template you can build a "package" <br>
> with all
the documentation, source code, materials, design files <br>> and extras that
you can easily share with anyone who wants to<br>> replicate your project.<br></div></div>Do you mean, that is your current practice toward a wiki engine you use, or do you mean in the future what should be great to get thanks to a new tool ?<br>
</div>Antoine (from small remote / rural place located in France )<br></div><div class="HOEnZb"><div class="h5"><div class="gmail_extra"><br><br><div class="gmail_quote">2013/10/16 Mario Gómez <span dir="ltr"><<a href="mailto:mxgxw.alpha@gmail.com" target="_blank">mxgxw.alpha@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">Hi Alicia,<br><br>Emilio Velis, the one that helped us to translate the best practices document to spanish told me that is going to work on a English-version of the repository over the weekend. The repository tries to follow the key points on best practices document.<br>
<br>The idea behind this, is that the repository could work like a "Framework", with a well defined folder structure, files and locations where you can put everything that you will need to build your OSHW proyect.<br>
<br>In software you can grab a package and compile by yourself. For OSHW projects I usually have to look in a wiki, then I need to download a file from another place, etc. The idea is that with this template you can build a "package" with all the documentation, source code, materials, design files and extras that you can easily share with anyone who wants to replicate your project.<br>
<br>The use of GitHub it's just plus that promotes keep tracking of the project evolution.<br><br>Regards,<br>Mario.<br><br><div><div><div><div><br></div></div></div></div></div><div><div><div class="gmail_extra">
<br><br><div class="gmail_quote">
On Mon, Oct 14, 2013 at 9:42 AM, Alicia Gibb <span dir="ltr"><<a href="mailto:pip@nycresistor.com" target="_blank">pip@nycresistor.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">Hi Mario,<div>Regretfully I cannot read Spanish well enough to translate, but I would assume you followed the best practices in your documentation repo. I'll be looking for someone to translate it into English - thanks!</div>
<span><font color="#888888">
<div><br></div><div>Alicia</div></font></span></div><div><div><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Oct 9, 2013 at 9:19 PM, Mario Gómez <span dir="ltr"><<a href="mailto:mxgxw.alpha@gmail.com" target="_blank">mxgxw.alpha@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">Thanks Alicia!<br><br>We uploaded the translation to the Open Hardware Community website here in El Salvador. I was reading in a previous message that you are working on a Wiki for the OSHWA that could be a better place to put the translation.<br>
<br>This is the link for our webpage (that also links to the Google Docs file on the previous messages):<br><br><a href="http://www.openhardware.sv/acerca-de/buenas-practicas-para-el-hardware-de-fuente-abierta/" target="_blank">http://www.openhardware.sv/acerca-de/buenas-practicas-para-el-hardware-de-fuente-abierta/</a><br>
<br>The credits in english go something like this:<br><br>"Translation to Spanish: September 26, 2013 by Mario Gómez in collaboration with Leonardo Saccomanno, Rafael Ibarra y Emilio Velis."<br><br>We also developed a GitHub template for documentation of Open-Source Hardware projects that is based on the good practices document.<br>
<br>Something that we identified here is that noone wants to write documentation, so we hope that the GitHub template not only helps people to follow a structure to document their projects, but also helps to incentivate them to use some kind of version control to keep track of the development of their proyects.<br>
<br>You can find the template (in Spanish) here:<br><br><a href="https://github.com/openhardwaresv/plantilla" target="_blank">https://github.com/openhardwaresv/plantilla</a><br><br>May be someone here could find the template useful and want to make the translation to english. :)<br>
<br>Regards,<br>Mario.<br><div><div><div><div><div><div><div><br><div><br></div></div></div></div></div></div></div></div></div><div><div><div class="gmail_extra"><br><br><div class="gmail_quote">
On Wed, Oct 9, 2013 at 12:50 PM, Alicia Gibb <span dir="ltr"><<a href="mailto:pip@nycresistor.com" target="_blank">pip@nycresistor.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">Thanks so much for your work on this - we will link your translation on the OSHWA website under the Best Practices tab - can you please let Aileen (cc'ed here) know who to list as contributors?<div>
<br></div>
<div>Thanks so much,</div><div>Alicia Gibb</div><div>OSHWA, Executive Director</div></div><div><div><div class="gmail_extra"><br><br><div class="gmail_quote">On Thu, Sep 26, 2013 at 8:17 PM, Pablo Kulbaba <span dir="ltr"><<a href="mailto:pablokulbaba@gmail.com" target="_blank">pablokulbaba@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 text="#000000" bgcolor="#FFFFFF">
Hi Mario.<br>
Just read it.<br>
Didn't notice anything to be corrected.<br>
Thanks Mario and contributors for the work.<br>
Will distribute.<br>
Saludos.<div><div><br>
<br>
<div>On 26/09/2013 07:51 p.m., Mario Gómez
wrote:<br>
</div>
<blockquote type="cite">
<div dir="ltr">Hi everybody!<br>
<br>
Appears that we didn't get new suggestions about the translation
since last week. And now the translation is a lot more easy to
read.<br>
<br>
I would think that is "stable" now and you could publish it :)<br>
<br>
You can find the final text on Google Docs:<br>
<br>
<a href="https://docs.google.com/document/d/1ARDEgCgPdAlMskRqrH7fPIc7j4p-1P9iQFDt6Zq0zZs/edit" target="_blank">https://docs.google.com/document/d/1ARDEgCgPdAlMskRqrH7fPIc7j4p-1P9iQFDt6Zq0zZs/edit</a><br>
<br>
I hope that you find it helpful!<br>
<br>
Regards,<br>
Mario<br>
<div>
<div><br>
</div>
</div>
</div>
<div class="gmail_extra"><br>
<br>
<div class="gmail_quote">On Thu, Sep 12, 2013 at 1:15 PM,
Catarina Mota <span dir="ltr"><<a href="mailto:catarina@openmaterials.org" target="_blank">catarina@openmaterials.org</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">Thanks Mario!</div>
<div>
<div>
<div class="gmail_extra"><br>
<br>
<div class="gmail_quote">
On Thu, Sep 12, 2013 at 3:13 PM, Mario Gómez <span dir="ltr"><<a href="mailto:mxgxw.alpha@gmail.com" target="_blank">mxgxw.alpha@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">Hi Catarina!<br>
<br>
I don't think that this version is going to have
more changes, but let's wait a week more to see
if there are any new comments. If not, we would
be very happy if you include the translation on
your website. The credits of the people that
helped with this are included at the end of the
translation.<br>
<br>
Regards,<br>
Mario<br>
<div><br>
<br>
</div>
</div>
<div>
<div>
<div class="gmail_extra"><br>
<br>
<div class="gmail_quote">On Thu, Sep 12,
2013 at 11:04 AM, Catarina Mota <span dir="ltr"><<a href="mailto:catarina@openmaterials.org" target="_blank">catarina@openmaterials.org</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">Thanks everyone of doing
this! Once you arrive at a stable
version, would you allow us to publish
the translation on OSHWA's website
(with proper attribution to the
translators)?</div>
<div>
<div>
<div class="gmail_extra">
<br>
<br>
<div class="gmail_quote">On Wed,
Sep 11, 2013 at 9:06 AM, Leo
Saccomanno <span dir="ltr"><<a href="mailto:leomsaccomanno@gmail.com" target="_blank">leomsaccomanno@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">Congratulations
Mario, the translation is
Really good!
<div><br>
<div>Although it can be
improved in order to
make the reading more
fluid (I will help with
that) your work is
awesome.<br>
</div>
</div>
</div>
<div>
<div>
<div class="gmail_extra">
<br>
<br>
<div class="gmail_quote">2013/9/11
Mario Gómez <span dir="ltr"><<a href="mailto:mxgxw.alpha@gmail.com" target="_blank">mxgxw.alpha@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>Thanks for
the suggestion!<br>
<br>
</div>
<div>We are going
to try and see
which works
better,<br>
<br>
</div>
<div>Regards,<br>
Mario.<br>
</div>
</div>
<div>
<div>
<div class="gmail_extra">
<br>
<br>
<div class="gmail_quote">
On Tue, Sep
10, 2013 at
10:50 PM,
Daniel Connell
<span dir="ltr"><<a href="mailto:sugarandfat@gmail.com" target="_blank">sugarandfat@gmail.com</a>></span>
wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
I've been
using
collaborative
documents to
crowdsource
the
translations<br>
for my site,
which has been
working pretty
good as
everyone can
edit the<br>
text in
realtime and
you don't have
any issues
with versions
getting out<br>
of step.<br>
For example: <a href="http://sync.in/collector-tut-spanish" target="_blank">http://sync.in/collector-tut-spanish</a><br>
<br>
I was using <a href="http://sync.in" target="_blank">sync.in</a>
to host the
pads, but
they've just
baitandswitched<br>
and don't
offer free
pads anymore.
<a href="http://piratepad.net" target="_blank">http://piratepad.net</a> is
essentially<br>
exactly the
same tho, and
still free.<br>
<br>
Then it's just
a matter of
copypasting
everything
over.<br>
<span><font color="#888888"><br>
Daniel.<br>
</font></span>
<div>
<div>_______________________________________________<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>
</div>
</div>
</blockquote>
</div>
<br>
</div>
</div>
</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" 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" 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" 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" 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>
<br>
<fieldset></fieldset>
<br>
<pre>_______________________________________________
discuss mailing list
<a href="mailto:discuss@lists.oshwa.org" target="_blank">discuss@lists.oshwa.org</a>
<a href="http://lists.oshwa.org/listinfo/discuss" target="_blank">http://lists.oshwa.org/listinfo/discuss</a>
</pre>
</blockquote>
<br>
</div></div><span><font color="#888888"><pre cols="72">--
PabloK</pre>
</font></span></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" 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" 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" 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" 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>