<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
  <channel>
    <title>Armstrap</title>
    <description>Armstrap is a community of engineers and makers determined to help make ARM prototyping easy and fun.</description>
    <link>http://armstrap.org/</link>
    <atom:link href="http://armstrap.org/feed.xml" rel="self" type="application/rss+xml" />
    <pubDate>Fri, 04 Sep 2015 04:06:48 +0000</pubDate>
    <lastBuildDate>Fri, 04 Sep 2015 04:06:48 +0000</lastBuildDate>
    <generator>Jekyll v2.4.0</generator>
    
      <item>
        <title>pyVirtualBench - Controlling Five Instruments from a Single Python Application</title>
        <description>&lt;p&gt;&lt;img src=&quot;/img/posts/2015/07/ni-virtualbench-python.jpg&quot; alt=&quot;Techshop VirtualBench&quot; class=&quot;centered img-responsive&quot; /&gt;&lt;/p&gt;

&lt;p&gt;Ever wanted to control five instruments from a single python script?  pyVirtualBench is a python library that gives to raw access to some pretty powerful engineering tools, all in a single application.&lt;/p&gt;

&lt;p&gt;If you’ve walked into a &lt;a href=&quot;http://www.techshop.ws&quot;&gt;TechShop&lt;/a&gt;, you’ve noticed that their electronics labs are outfitted with an interesting instrument at every station.  That instrument is National Instrument’s &lt;a href=&quot;http://www.ni.com/virtualbench/&quot;&gt;VirtualBench&lt;/a&gt; and it takes a radically different approach to instrumentation.  Rather than buying separate instruments (like a power supply, dmm, scope, function generator, DIO logic analyser), VirtualBench combines these instruments into a single package.  Five instruments in one convenient package.  That’s not bad.&lt;/p&gt;

&lt;p&gt;&lt;img src=&quot;/img/posts/2015/07/techshop-virtualbench.jpg&quot; alt=&quot;Techshop VirtualBench&quot; title=&quot;Image courtesy of sfgate.com&quot; class=&quot;centered img-responsive&quot; /&gt;&lt;/p&gt;

&lt;p&gt;There’s already enough &lt;a href=&quot;http://www.ni.com/virtualbench/what-is&quot;&gt;marketing material&lt;/a&gt; on the web so I’m not going to go into the specs of the machine.  What I’ll be talking about is the advantage of combining these instruments to get work done that was previously not possible had these instruments been separate boxes.&lt;/p&gt;

&lt;p&gt;One of the things that has bugged me for a long time about traditional instruments is the idea that no matter the instrument, they encourage me to do things I don’t want to do.  For example, if I needed to do a series of tests on several boards, I don’t want to constantly be fiddling with my instrument’s configuration.  And when actually testing my board, I don’t want to constantly look at my display (which can sometimes be several feet away).  I want to keep my eyes on the work and my hands on my probes.&lt;/p&gt;

&lt;p&gt;Thanks to National Instruments releasing a c-api to their driver, &lt;a href=&quot;https://github.com/armstrap/armstrap-pyvirtualbench/tree/master/lib&quot;&gt;I wrote a Python wrapper&lt;/a&gt; that allows me to easily interface with the VirtualBench instrument.&lt;/p&gt;

&lt;p&gt;For this demo, I’m going to be using a simple 3-switch USB foot pedal I purchased on Amazon for about 55 US dollars.  Cheaper foot pedals exist, but I really liked the quality of this particular unit.  I’ll only be using one of the three switches but I can easily see myself using all three switches to do other things, like perhaps triggering or starting a particular measurement.&lt;/p&gt;

&lt;p&gt;&lt;img src=&quot;/img/posts/2015/07/usb-foot-pedal.jpg&quot; alt=&quot;Infinity USB Digital Foot Control&quot; class=&quot;centered img-responsive&quot; /&gt;&lt;/p&gt;

&lt;p&gt;I’ll also be using Google’s Text-to-Speech API to output my measurement to my computer’s speaker.&lt;/p&gt;

&lt;p&gt;In my &lt;a href=&quot;https://github.com/armstrap/armstrap-pyvirtualbench/blob/master/examples/hands_free_dmm.py&quot;&gt;application&lt;/a&gt;, I want to do three different kinds of tests: a voltage test, a resistance test and a continuity test.  I’m using the foot pedal to cycle through the various instruments.  My ears will be listening for each measurement result, allowing my eyes can stay on my work and my hands can stay on my probes.&lt;/p&gt;

&lt;p&gt;And because my application is written in python, changes are as simple as opening and editing my script in a regular text editor, making customizations and tweaks relatively easy.&lt;/p&gt;

&lt;iframe width=&quot;480&quot; height=&quot;270&quot; src=&quot;http://www.youtube.com/embed/1NOQRLI39es&quot; frameborder=&quot;0&quot; allowfullscreen=&quot;&quot;&gt;&lt;/iframe&gt;

&lt;p&gt;I’m really excited about VirtualBench and I’m excited to see where this instrument will go.  Got a VirtualBench and want to try it out?  I’ve released the Python wrapper in our &lt;a href=&quot;https://github.com/armstrap/armstrap-pyvirtualbench&quot;&gt;GitHub repository&lt;/a&gt;.  I’m excited to see what you guys can come up with.  Drop me a line if you do something cool.&lt;/p&gt;

</description>
        <pubDate>Mon, 27 Jul 2015 00:00:00 +0000</pubDate>
        <link>http://armstrap.org/2015/07/27/pyvirtualbench-controlling-five-instruments-from-a-single-python-application/</link>
        <guid isPermaLink="true">http://armstrap.org/2015/07/27/pyvirtualbench-controlling-five-instruments-from-a-single-python-application/</guid>
        
        
      </item>
    
      <item>
        <title>Armstrap Eagle Pinout Cards Arrived</title>
        <description>&lt;p&gt;&lt;img src=&quot;/img/posts/2015/04/armstrap-eagle-pinout-card-floor.JPG&quot; alt=&quot;Armstrap Eagle Pinout Card&quot; class=&quot;centered img-responsive&quot; /&gt;&lt;/p&gt;

&lt;p&gt;One user gave us feedback that we should consider including an &lt;a href=&quot;http://armstrap.org/eagle&quot;&gt;Armstrap Eagle&lt;/a&gt; pinout diagram card in the shipment box.  You asked, we delivered.  Effective immediately (until supplies last), all Armstrap Eagle shipments will include a small card that outlines the board’s pinout.  It’s just another way we are improving ourselves.&lt;/p&gt;

&lt;p&gt;If you already have your Armstrap Eagle board and you don’t have the pinout diagram card, you can get the pinout in the &lt;a href=&quot;http://docs.armstrap.org/en/latest/hardware-overview.html#armstrap-eagle&quot;&gt;documentation section&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;If you have feedback, let us know.  We have a &lt;a href=&quot;http://community.armstrap.org/&quot;&gt;community section&lt;/a&gt; where makers and entrepreneurs just like you can share their ideas and help make the site better for everyone.&lt;/p&gt;

&lt;p&gt;Thumbs up to &lt;a href=&quot;http://www.vistaprint.com&quot;&gt;Vistaprint&lt;/a&gt; for the great quality and speedy turnaround time.&lt;/p&gt;

&lt;p&gt;&lt;img src=&quot;/img/posts/2015/04/armstrap-eagle-pintout-card.JPG&quot; alt=&quot;Armstrap Eagle Pinout Card&quot; class=&quot;centered img-responsive&quot; /&gt;&lt;/p&gt;

</description>
        <pubDate>Fri, 17 Apr 2015 00:00:00 +0000</pubDate>
        <link>http://armstrap.org/pinout/2015/04/17/eagle-pinout-cards-arrived/</link>
        <guid isPermaLink="true">http://armstrap.org/pinout/2015/04/17/eagle-pinout-cards-arrived/</guid>
        
        
        <category>pinout</category>
        
      </item>
    
      <item>
        <title>Surviving Slashdot and Hacker News</title>
        <description>&lt;p&gt;We were recently featured on the front of &lt;a href=&quot;http://hardware.slashdot.org/story/15/04/07/1837249/armstrap-claims-to-make-arm-prototyping-easier-video&quot;&gt;Slashdot&lt;/a&gt; and then got picked up by &lt;a href=&quot;https://news.ycombinator.com/item?id=9338322&quot;&gt;Hacker News&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;http://hardware.slashdot.org/story/15/04/07/1837249/armstrap-claims-to-make-arm-prototyping-easier-video?continuous_video=1#ooid=NnYnZjdDrAEMtaUyMcf_UqgmKRmkKvmn&quot;&gt;&lt;img src=&quot;/img/posts/2015/04/slashdot-video-thumbnail.png&quot; alt=&quot;Armstrap on Slashdot&quot; /&gt;&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Despite the barrage of hits that came to the site, armstrap.org never suffered an outage.  This is in part thanks to our site being hosted on &lt;a href=&quot;https://github.com/armstrap/armstrap.github.io&quot;&gt;Github&lt;/a&gt; via &lt;a href=&quot;https://pages.github.com/&quot;&gt;Github Pages&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;Thank you also goes out to the team at VOV Technology, who successfully build the boards corresponding to the orders that came shortly afterwards.  Many people don’t realize that VOV is experimenting with build-to-order boards.  That is, there are no stockpile of already-made ready-to-ship Armstrap boards.  The boards are built, tested and shipped as they are ordered.&lt;/p&gt;

&lt;p&gt;We will be spending the next few weeks improving our documentation and getting-started experience, particularly on the Windows platform.  Thank you to everyone who gave feedback in the &lt;a href=&quot;community.armstrap.org&quot;&gt;community&lt;/a&gt;.&lt;/p&gt;

</description>
        <pubDate>Tue, 14 Apr 2015 00:00:00 +0000</pubDate>
        <link>http://armstrap.org/2015/04/14/surviving-slashdot-and-hackernews/</link>
        <guid isPermaLink="true">http://armstrap.org/2015/04/14/surviving-slashdot-and-hackernews/</guid>
        
        
      </item>
    
      <item>
        <title>SXSW Time</title>
        <description>&lt;h1 id=&quot;armstrap-will-be-at-sxsw-create1&quot;&gt;Armstrap will be at &lt;a href=&quot;http://sxsw.com/exhibitions/sx-create&quot;&gt;SXSW Create&lt;/a&gt;!&lt;/h1&gt;

&lt;p&gt;&lt;img src=&quot;/img/posts/2015/03/sxcreate_logo-dates-location_cmyk-b.png&quot; alt=&quot;SXSW Create&quot; class=&quot;centered img-responsive&quot; /&gt;&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Dates:&lt;/strong&gt; March 13–15, 2015&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Hours:&lt;/strong&gt; 11:00am–6:00pm&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Location:&lt;/strong&gt; City Terrace of the Long Center (701 W. Riverside)&lt;/p&gt;

&lt;h2 id=&quot;this-event-is-free-and-open-to-the-public&quot;&gt;This event is FREE and Open to the Public&lt;/h2&gt;

&lt;p&gt;If you are in the Austin area, be sure to stop by our SXSW booth.  We plan on demoing some armstrap boards, have programming contests, and give away prizes.  We are located near the entrance of the Palmer Events Center.&lt;/p&gt;

&lt;p&gt;&lt;img src=&quot;/img/posts/2015/03/sxsw-armstrap-booth.png&quot; alt=&quot;Armstrap Booth&quot; class=&quot;centered img-responsive&quot; /&gt;&lt;/p&gt;

</description>
        <pubDate>Thu, 12 Mar 2015 00:00:00 +0000</pubDate>
        <link>http://armstrap.org/sxsw/2015/03/12/sxsw%20booth/</link>
        <guid isPermaLink="true">http://armstrap.org/sxsw/2015/03/12/sxsw%20booth/</guid>
        
        
        <category>sxsw</category>
        
      </item>
    
      <item>
        <title>Fast and Furious Upgrades</title>
        <description>&lt;p&gt;We’ve been busy upgrading…pretty much everything.&lt;/p&gt;

&lt;p&gt;&lt;img src=&quot;/img/posts/2014/11/fast_and_furious_6.jpg&quot; alt=&quot;Fast and Furious Upgrades&quot; class=&quot;centered img-responsive&quot; /&gt;&lt;/p&gt;

&lt;p&gt;The armstrap.org site is composed of two sections: a blog section and a community section.  Both sections have been upgraded and are now insanely fast and much more scalable.&lt;/p&gt;

&lt;ul&gt;
  &lt;li&gt;
    &lt;p&gt;The blog section used to be an Amazon EC2 Linux VM with 512MB of RAM hosting WordPress.  That was fine as long as traffic was low.  When traffic got high, the machine would crash due to memory constraints.  Finally, when a failed WordPress update took down the php-engine (the engine used to run WordPress), we looked at other, easier to maintain blog engines.  We settled on &lt;a href=&quot;http://jekyllrb.com&quot;&gt;jekyll&lt;/a&gt; (hosted on &lt;a href=&quot;http://jekyllrb.com/docs/github-pages/&quot;&gt;github page&lt;/a&gt;) because it was easy to use and much more scalable.  All posts are now simple markdown text files used to generate static html pages.&lt;/p&gt;
  &lt;/li&gt;
  &lt;li&gt;
    &lt;p&gt;The Community section also got a major upgrade.  We went from an Amazon EC2 single-core 4GB of RAM HD-based Linux VM to a Microsoft Azure dual-core 8GB of RAM SSD-based Linux VM.  This has helped significantly improve the performance of the community site.  The software behind the community site, &lt;a href=&quot;http://www.discourse.org&quot;&gt;Discourse&lt;/a&gt;, also got an upgrade.&lt;/p&gt;
  &lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;We hope you enjoy the improvements.&lt;/p&gt;

</description>
        <pubDate>Tue, 11 Nov 2014 00:00:00 +0000</pubDate>
        <link>http://armstrap.org/upgrades/2014/11/11/site%20upgrades/</link>
        <guid isPermaLink="true">http://armstrap.org/upgrades/2014/11/11/site%20upgrades/</guid>
        
        
        <category>upgrades</category>
        
      </item>
    
      <item>
        <title>Why One Community Member Switched from Arduino to the Armstrap Eagle</title>
        <description>&lt;p&gt;&lt;img src=&quot;/img/posts/2014/08/hoss-eagle-breadboard.jpg&quot; alt=&quot;Hoss Development Setup&quot; class=&quot;centered img-responsive&quot; /&gt;&lt;/p&gt;

&lt;blockquote&gt;
  &lt;p&gt;“I came over to Armstrap from Arduino because I was growing increasingly frustrated with the IDE and toolchain. Don’t get me wrong, I love Arduino and how it’s enabling beginners to really get their hands dirty in electronics and programming without needing to know the ins and outs of using a compiler or flashing an MCU, but when you move from trying to learn how something works or doing a few simple routines to trying to use advanced features of a specific chip, it can start to get cumbersome.” // Hoss, Armstrap community member&lt;/p&gt;
&lt;/blockquote&gt;
</description>
        <pubDate>Wed, 20 Aug 2014 00:00:00 +0000</pubDate>
        <link>http://armstrap.org/2014/08/20/why-one-community-member-switched-from-arduino-to-armstrap/</link>
        <guid isPermaLink="true">http://armstrap.org/2014/08/20/why-one-community-member-switched-from-arduino-to-armstrap/</guid>
        
        
      </item>
    
      <item>
        <title>Supermechanical Loves Armstrap</title>
        <description>&lt;iframe width=&quot;560&quot; height=&quot;315&quot; src=&quot;//www.youtube.com/embed/ApWAGwy-xMI&quot; frameborder=&quot;0&quot; allowfullscreen=&quot;&quot;&gt; &lt;/iframe&gt;
</description>
        <pubDate>Tue, 13 May 2014 00:00:00 +0000</pubDate>
        <link>http://armstrap.org/2014/05/13/supermechanical-loves-armstrap/</link>
        <guid isPermaLink="true">http://armstrap.org/2014/05/13/supermechanical-loves-armstrap/</guid>
        
        
      </item>
    
      <item>
        <title>The Importance of Easy Manufacturing</title>
        <description>&lt;p&gt;What &lt;a href=&quot;http://www.digikey.com/en/articles/techzone/2013/jun/life-after-pi&quot;&gt;experts predicted&lt;/a&gt; has finally happened.  People are using the &lt;a href=&quot;http://beagleboard.org/Products/BeagleBone+Black&quot;&gt;BeagleBone Black&lt;/a&gt; and &lt;a href=&quot;http://www.raspberrypi.org/&quot;&gt;Raspberry Pi&lt;/a&gt; for more than just prototyping.  They are using them as critical pieces to their deployed solution.&lt;/p&gt;

&lt;p&gt;There’s just one problem.  These tiny all-in-one mini computers were never designed to be deployed in an end-product.&lt;/p&gt;

&lt;p&gt;&lt;img src=&quot;/img/posts/2014/03/beaglebone-black-assembly.png&quot; alt=&quot;BeagleBone Black Assembly&quot; class=&quot;centered img-responsive&quot; /&gt;&lt;/p&gt;

&lt;p&gt;&lt;a href=&quot;http://mx.mouser.com/new/embedded-solutions/beagleboneblack&quot;&gt;Companies that sell&lt;/a&gt; the BeagleBone Black are now reporting huge backlogs totaling &lt;a href=&quot;http://mx.mouser.com/ProductDetail/CircuitCo/BB-BBLK-000/?qs=%2fha2pyFadugh6wNMONnDuAbTwbrIHVw4R%2f%252bth5Q2M%2fX2Gs60muroNw%3d%3d&quot;&gt;14,000 units&lt;/a&gt;.  It’s really hard to get a hold of these boards and according to Gerald Coley, the designer of the BeagleBone Black and systems engineer at Texas Instrument (the company sponsoring the BeagleBone Black), the problem is not going away anytime soon.&lt;/p&gt;

&lt;p&gt;Gerald &lt;a href=&quot;https://groups.google.com/forum/#!topic/beagleboard/Z3JfUIkxOl8[101-125-false]&quot;&gt;writes&lt;/a&gt;…&lt;/p&gt;

&lt;blockquote&gt;
  &lt;p&gt;We have doubled our production over the last two months to 3,000 per week. But that is about as good as it is going to get. We still have people sucking up 100s of boards for use in products and we have not found a way to stop that. We are building them and we are shipping them as fast as we can. They just aren’t getting to people that we want to have them.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;The BeagleBone Black and Raspberry Pi fall into a category of electronics I call the put-everything-on-a-pcb-and-make-it-cheap type of device.  They don’t need to worry about drivers because they have their own on-board operating system.  These solutions make prototyping a joy because they offer fertile soil to grow the seeds of a maker’s dream.&lt;/p&gt;

&lt;p&gt;There is just one big problem: these solutions do not scale.&lt;/p&gt;

&lt;p&gt;These all-in-one boards seduce entrepreneurs, who find themselves at a loss when it comes time to scale their solution.  Naturally, these startups cannot reproduce any of these low cost devices and preserve their low price point.  Yes, they are open source and that’s a big win.  But if you cannot scale your solution, why would any startup consider using one of these all-in-one devices?  Why would your core component be tied to another company’s supply chain?&lt;/p&gt;

&lt;p&gt;Armstrap is  different.  &lt;strong&gt;We care about the ability to mass produce your solution.&lt;/strong&gt;  That’s why the &lt;a href=&quot;/eagle&quot;&gt;Armstrap Eagle&lt;/a&gt; is made using 0805-sized components on a simple 2-layer PCB.  They can easily be recreated by hand if need be.  And thanks to its open-source license and to services like &lt;a href=&quot;https://oshpark.com/&quot;&gt;OSH Park&lt;/a&gt; and &lt;a href=&quot;http://www.oshstencils.com/&quot;&gt;OSH Stencils&lt;/a&gt; anyone can remix the board and hand-solder a new prototype.  If your Kickstarter is massively successful, then you can make the adjustments necessary to lower costd: for example eliminating the integrated JTAG debugger if its not required.&lt;/p&gt;

&lt;p&gt;Rather than giving makers everything on a board and slapping an operating system on top, &lt;strong&gt;we embrace the hardware and focus on making it easier to develop, debug and deploy your solution.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Want to buy an Armstrap Eagle?  We &lt;a href=&quot;/eagle&quot;&gt;sell them on the website&lt;/a&gt;, however, they can be built by hand too.  More on that later.&lt;/p&gt;

</description>
        <pubDate>Tue, 18 Mar 2014 00:00:00 +0000</pubDate>
        <link>http://armstrap.org/2014/03/18/the-importance-of-easy-manufacturing/</link>
        <guid isPermaLink="true">http://armstrap.org/2014/03/18/the-importance-of-easy-manufacturing/</guid>
        
        
      </item>
    
      <item>
        <title>It Works on a MAC</title>
        <description>&lt;p&gt;&lt;img src=&quot;/img/posts/2013/12/armstrap-mac-featured.jpg&quot; alt=&quot;armstrap on a mac&quot; class=&quot;centered img-responsive&quot; /&gt;&lt;/p&gt;

&lt;p&gt;Quarter by quarter, news outlets are reporting that &lt;a href=&quot;http://www.pcmag.com/article2/0,2817,2417655,00.asp&quot;&gt;PC sales are either flat&lt;/a&gt; or plummeting.  HP just announced &lt;a href=&quot;http://www.pcmag.com/article2/0,2817,2428865,00.asp&quot;&gt;another layoff&lt;/a&gt; in an on-going effort to restructure and reinvent themselves.  Dell went as far as to &lt;a href=&quot;http://www.forbes.com/sites/connieguglielmo/2013/10/30/you-wont-have-michael-dell-to-kick-around-anymore/&quot;&gt;convert themselves to a private company&lt;/a&gt;.  Since we are not in an economic depression, all of these articles hint at one fundamental fact–Mac sales are rising.&lt;/p&gt;

&lt;p&gt;When I look at the options embedded developers have on the Mac, the outcome is grim.  External JTAG devices require a proprietary driver to enumerate and those JTAG vendors only ship drivers for the PC.  That shiny new MacBook Pro can’t do any real-world embedded development without a lot of hackery.  It’s no wonder that products like the &lt;a href=&quot;http://beagleboard.org/products/beaglebone%20black&quot;&gt;BeagleBone Black&lt;/a&gt; and the &lt;a href=&quot;http://www.raspberrypi.org/&quot;&gt;Raspberry Pi&lt;/a&gt; exist.  It’s easier to put an entire operating system on a chip than to create a new driver stack for a different ecosystem, &lt;a href=&quot;http://www.apple.com/legal/macapps/stdeula/&quot;&gt;riddled with lawyers&lt;/a&gt; and politics.  No drivers are required when your embedded board ships with an entire operating system on board.  But what happens to those developers who want to be close to the hardware?  These developers don’t want an operating system in the way of their time-critical projects.&lt;/p&gt;

&lt;p&gt;Armstrap is different.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Armstrap boards don’t abstract away the hardware, they embrace it.&lt;/strong&gt;  Rather than putting a TCP/IP between your code and the hardware, Armstrap boards connect to your project directly via a standard USB cable.  There are no external adapters to worry about.  Debugging is done on any platform (Windows, Mac or Linux) because Armstrap boards enumerate as a tty serial device, utilizing the standard USB driver stack.  Debugging is ultra fast and snappy thanks to the heavy lifting done by the open source debugger that comes integrated on every Armstrap board.&lt;/p&gt;

&lt;p&gt;Finally, ARM development that actually works on a Mac.&lt;/p&gt;

</description>
        <pubDate>Tue, 31 Dec 2013 00:00:00 +0000</pubDate>
        <link>http://armstrap.org/2013/12/31/it-works-on-a-mac/</link>
        <guid isPermaLink="true">http://armstrap.org/2013/12/31/it-works-on-a-mac/</guid>
        
        
      </item>
    
      <item>
        <title>Documentation Facelift</title>
        <description>&lt;p&gt;&lt;img src=&quot;/img/posts/2013/12/jens-schott-knudsen-flickr.jpg&quot; alt=&quot;Guy in Subway Reading&quot; class=&quot;centered img-responsive&quot; /&gt;&lt;/p&gt;

&lt;p&gt;I think that for any open-hardware community to thrive, that community has to have insanely-great documentation.  Great documentation is not just in the form of web pages on a screen, but also PDF and ePub documentation that you can take on-the-go.  Documentation teaches others how to use your product and learning and discovery is a big part of Armstrap.&lt;/p&gt;

&lt;p&gt;Like most engineers, I find documentation hard.  They are great to read, but difficult to write.  Why?  Because too often, documentation becomes a war of styles, tags, placement and deployment.  Like programming, documentation is riddled with rules and getting the simplest projects off the ground requires an enormous amount of effort.  This enormous effort has nothing to do with the message you are trying to convey.  Rather than helping you, they stand in your way, forcing you to learn their quirks.  Writing anything will take time because the author has to overcome these hurdles.  Luckily, two technologies exists that can alleviate much of this pain–&lt;a href=&quot;http://docutils.sourceforge.net/rst.html&quot;&gt;reStructuredText&lt;/a&gt; and &lt;a href=&quot;https://readthedocs.org/&quot;&gt;readthedocs.org&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;reStructuredText is a markdown language that is incredibly rich in syntax and easy to learn.  It does a fantastic job hiding those complex XML/HTML/DocBook tags, giving authors the freedom to express themselves in a plain-ol’ text editor.  Unlike those tag-based approaches to documentation, reStructuredText has no tags.  That’s right.  None.  reStructuredText uses an intelligent approach to documentation where styling and formatting is inferred based off text spacing and layout.  If you have five minutes, check out the &lt;a href=&quot;http://docutils.sourceforge.net/docs/user/rst/quickref.html&quot;&gt;reStructuredText cheatsheet&lt;/a&gt; and the &lt;a href=&quot;http://rst.ninjs.org/&quot;&gt;online editor&lt;/a&gt;.  I found it amazing how fast and easy it was to learn.  Try doing this with DocBooks.&lt;/p&gt;

&lt;p&gt;But what about deployment?  Getting documentation written is one challenge but deployment can be a greater challenge.  Generating HTML, PDF, and ePub for consumers can be an equally difficult task.  That’s where Read the Docs come in.&lt;/p&gt;

&lt;p&gt;The readthedocs.org service is amazing!  In a nutshell, they translate reStructuredText from a github repository into beautiful, clean documentation.  They automatically generate HTML, PDF and ePub front-ends that make documentation kind of fun.  It’s free and it looks fantastic, even on a mobile device.  Did I say this happens automatically?  If you have five minutes, check out their &lt;a href=&quot;https://www.youtube.com/watch?feature=player_embedded&amp;amp;v=oJsUvBQyHBs&quot;&gt;screencast&lt;/a&gt;.&lt;/p&gt;

&lt;p&gt;We recently revamped our &lt;a href=&quot;http://docs.armstrap.org/&quot;&gt;tutorials and getting started guides&lt;/a&gt; to use reStructuredText and readthedocs.org.  In the future, we plan on getting more tutorials and guides published using these technologies.  Documentation is fun again!&lt;/p&gt;

</description>
        <pubDate>Mon, 23 Dec 2013 00:00:00 +0000</pubDate>
        <link>http://armstrap.org/2013/12/23/documentation-facelift/</link>
        <guid isPermaLink="true">http://armstrap.org/2013/12/23/documentation-facelift/</guid>
        
        
      </item>
    
  </channel>
</rss>
