A place to cache linked articles (think custom and personal wayback machine)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

index.md 7.3KB

5 years ago
12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849
  1. title: The 100:10:1 method: my approach to open source
  2. url: http://blog.fogus.me/2015/11/04/the-100101-method-my-approach-to-open-source/
  3. hash_url: 4a0166954570aaa8bb250e098e9d83e1
  4. <p>For many years I was whole hog into the open-source movement and at the time I rarely wrote a stitch of code in my free time that didn’t find itself in a public Sourceforge/GCode/Github repo.<sup id="fnref:more"><a href="#fn:more" rel="footnote">1</a></sup> However, over time I came to learn that the burden that came with publicly offering code to the universe, to put it mildly, sucked. Aside from the fact that much of the code that was “released” was sub-par, the very act of putting code out into the world implied (whether <a href="https://en.wikipedia.org/wiki/Authorial_intent">intentionally</a>, or <a href="https://en.wikipedia.org/wiki/Reader-response_criticism">not</a>) a willingness to participate in a social contract<sup id="fnref:moral"><a href="#fn:moral" rel="footnote">2</a></sup> with those who chose to use it for their own purposes. Granted I’m not necessarily against that social contract per se, instead my eventual change of heart around releasing code became such that I was more reserved in my approach. The approach that I now use for releasing code into the wild is governed by an approach called the “100:10:1 method,” a term coined by Nick Bentley.<sup id="fnref:bent"><a href="#fn:bent" rel="footnote">3</a></sup></p>
  5. <h2>What even is the 100:10:1 method?</h2>
  6. <p>I won’t belabor the details of the method, you can read more about it <a href="https://nickbentleygames.wordpress.com/2014/05/12/the-100-10-1-method-for-game-design/">from the perspective of a talented game designer</a>, but I’ll try to frame it in the context of my approach to open source software development.</p>
  7. <p>The 100:10:1 method has three parts, each described below.</p>
  8. <h3>Write down 100 wacky ideas</h3>
  9. <p>The first step was to find a notebook and a pen and just write down 100 ideas for interesting open source projects. These project ideas ranged across all manner of topics, depth, and quality. I thought of wild language ideas, new features in existing projects, system designs, protocols, missing documentation, interesting forks, golfing code, games, prototypes, implementations of paper ideas, second-systems, whatever.</p>
  10. <p><img src="http://blog.fogus.me/wp-content/uploads/2015/11/notes-300x119.jpg" alt="notes"/></p>
  11. <p>Prior to incorporating the 100:10:1 method, I had always had a notebook filled with wacky ideas, but they tended to be hither and thither and never in one place. Laying 100 ideas out on a few pages let me really focus my attention on them all at once, allowing me to weigh them against each other for the purposes of the second step.</p>
  12. <h3>Make a MVP for 10 of those ideas</h3>
  13. <p>Having 100 ideas laid out in front of me let me really get a grasp on the ideas that I not only felt interested in pursuing at that time, but also those that I felt could benefit not only myself, but others as well.<sup id="fnref:oss"><a href="#fn:oss" rel="footnote">4</a></sup> Of the original 100 I picked 10 projects that I was certain I wanted to dive into and explore. For lack of a better term I picked the 10 projects that I wanted to write a minimum viable “product” for all — <em>concurrently</em>.</p>
  14. <p><img src="http://blog.fogus.me/wp-content/uploads/2015/11/vs-300x169.png" alt="proto"/></p>
  15. <p>Now you might be thinking that 10 concurrent projects is in itself a burden. This would not be an incorrect assessment. However, I realized that minimum viable implementations for most of the projects that I chose would probably never see the light of day and if they did it would be months to years before that time. You see, at one time I had viewed releasing open source software as a method for putting a potentially useful tool into the hands of others. Sadly, over time that view had degenerated into the idea that releasing code into the wild was in itself good — the method had supplanted the original goal. My view now is that it’s highly likely that the code that I’m working on in my spare time is only an exploration that may or may not bear fruit — and that’s OK.</p>
  16. <p>A nice benefit of working on 10 concurrent projects is that when I feel that one has stagnated I can simply move on to another that motivates me more. As a person with a rich hobby, community, and family life outside of mere coding, it benefits me immensely to use the power of a bevy of choice to battle fleeting interest. Having 10 concurrent projects means that there’s always one that can grab my immediate interest. I’ve learned (the hard way) that when my full interest is directed on a task I’m much more efficient in my production. Eventually however, one of these projects will bear fruit<sup id="fnref:rotten"><a href="#fn:rotten" rel="footnote">5</a></sup> and when that happens I’m ready for the final stage.</p>
  17. <h3>Fully develop one of those ideas into a legitimate software release</h3>
  18. <p>At some point during the 10-stage, one of the projects will inevitably turn into something valuable.<sup id="fnref:viable"><a href="#fn:viable" rel="footnote">6</a></sup> When that happens I then take that one project and really work to turn it into a quality software artifact.<sup id="fnref:keepgo"><a href="#fn:keepgo" rel="footnote">7</a></sup> This means to go all the way and ensure a robust system with solid examples, tests, documentation, stable API, blog posts and/or talks, and even a web-presence perhaps.<sup id="fnref:logo"><a href="#fn:logo" rel="footnote">8</a></sup></p>
  19. <p><img src="http://blog.fogus.me/wp-content/uploads/2015/11/proj.png" alt="z"/></p>
  20. <p>Up until this point the code for said project was for my own purposes and would likely need a lot of work to make it into something that I’d be proud to share with others. It depends on the complexity of the software of course, but it’s likely that the final stage takes the longest amount of time to realize. Likewise, it’s at this final stage that I’m most likely to scrap a project entirely. I’ve found (again, the hard way) that if I can’t bring myself to turn a codebase into something that I’m willing to write documentation, examples, and tests for then there’s zero chance that I’ll be willing to maintain it for the next X years.</p>
  21. <h2>Conclusion</h2>
  22. <p>I’ve used this method for some time now, and prior to that I followed something similar and have found good results so far. That is, both <a href="https://www.youtube.com/watch?v=1E2CoObAaPQ">Zeder and Patagonia</a> were developed using the 100:10:1 method, or some facsimile of it and I have a Clojure library named “Tathata” that’s in the final stages right now. Perhaps one of my 10 current projects<sup id="fnref:gd"><a href="#fn:gd" rel="footnote">9</a></sup> will bear similar fruit, but if not that’s OK, I’ll just pick 10 more.</p>
  23. <p><img src="http://blog.fogus.me/wp-content/uploads/2015/11/100-10-1-300x171.png" alt="tree"/></p>
  24. <p>I’ve got plenty of time — a lifetime indeed.</p>
  25. <p>:F</p>
  26. <p><em>Thanks to <a href="https://twitter.com/gigasquid">Carin Meier</a>, <a href="https://twitter.com/richhickey">Rich Hickey</a>, <a href="https://twitter.com/jgehtland">Justin Gehtland</a>, and <a href="https://github.com/ohpauleez">Paul deGrandis</a> for reading and providing feedback to a draft of this post.</em></p>