July 2011
1 post
Clearing Launchpad and other OS X Lion (10.7) Tips →
I just installed Lion today, though I had been using the Developer Previews for a while now. I like Lion, but some things irk me. I’ve compiled a list of tips that I use to make my experience more…
June 2011
1 post
SlimGems, a drop-in replacement for RubyGems →
A couple weeks ago, prior to RailsConf, I started working with a few others to fix some major issues with the RubyGems 1.8.x releases that were breaking or otherwise incapacitating tons…
May 2011
0 posts
An Update on Macros in YARD 0.7.x →
YARD 0.7.x has a feature on the table called macros. This allows developers documenting code to very quickly create documentation templates for repetitive DSL methods. The more trivial part of…
April 2011
2 posts
Exposing the Right Details: A Tale of Two... →
A few days ago I had a discussion on twitter with @jacobian (Jacob Kaplan-Moss) about the supposed implicit failure of using auto generated documentation tools in Ruby; RDoc, YARD, and the like….
December 2010
1 post
Too Lazy to "Type" →
Are we really writing “dynamic” programs, or are we just trying to avoid writing down all those type signatures?
I’m currently doing research for a survey on [program] verification and testing in…
August 2010
1 post
Announcing YARD 0.6.0 →
Today I’m announcing the release of YARD 0.6.0, codenamed “The Cubic”. I wrote a few articles in the last 2 months about the upcoming features, and I’m proud to announce that all of those…
June 2010
4 posts
YARD Object Oriented Diffing →
Yesterday I tweeted a bunch about a new command in the upcoming YARD 0.6 release called yard diff which lets you perform object-aware diffs across two versions of a project/library/gem. I wanted to…
Announcing MiddleButtonScroll for Safari 5 →
A while back (in May), I made a Chrome extension called MiddleButtonScroll for the then new extension support. Now that Safari 5 is out with extension support of its own (and from a first glance,…
Preview of YARD 0.6 Features →
YARD 0.5.7 is currently in the works and is possibly a week or so from release. After that version is put out there (pending no serious issues), all “yardwork” will be exclusively dedicated to the…
Defining the “Engine” →
Engines in the automotive industry (and pretty much all other vehicle industries) have a very strict definition. The word is so strictly defined that just about every engine manufacturer…
April 2010
1 post
Thoughts on Jobs’ Thoughts on Flash →
Steve Jobs recently wrote a pretty revealing and honest explanation into why iPhone OS (and Apple in general) won’t use Flash. He pointed out some pretty interesting and subtle issues like…
March 2010
1 post
Documentation and the Whole Nine YARDs (MWRC 2010) →
The following was the talk I gave at MWRC 2010 a few weeks back. There are also a few slides that didn’t make the actual talk. When the video is released, I’ll put up a link to that too.
December 2009
5 posts
Visualizing Class Relationships with YARD and... →
Note: This post requires an HTML5 capable browser. FF3.5+, Safari, Chrome (or any WebKit browser) will do the trick. That should cover most of my readers.
I love visualization toolkits, so when I…
Using yri for Ruby Core Classes →
This functionality requires a couple of changes made in 0.5.1 (released today), so be sure to update yard to the latest release.
You can now use yri with Ruby core classes. This is relatively old…
Announcing The Longest YARD: 0.5.0 →
YARD 0.5.0 (“The Longest”) was just released today. It features a bunch of new things, but some of the most awesome are:
Support for documenting native Ruby C code
Incremental file parsing and…
The Three Issues Keeping Me Off Chrome →
Important Note: at least 90% of this is subjective and opinionated. You might love everything Chrome has to offer. I’d rather have a browser that can offer the best to everyone and not force its…
Auto-Generated ER Diagrams of Popular Rails... →
I discovered yUML.me today. It’s a really awesome project and allows you to hotlink UML class, activity or use-case diagrams on any page. All of the UML data is in the URL itself, so it’s real…
November 2009
5 posts
Generate YARD Docs for Your Gem →
A little tidbit that most people don’t know about is that since 0.2.3.5, YARD can actually be used in place of RDoc to generate documentation when a gem is installed. All you need to do is add the…
Customizing YARD Templates →
I usually sift over this little snippet of an extension when I give talks on YARD. I haven’t written it down until now because the templating system was pretty much up in the air for the last year…
YARD 0.4.0 (The Whole Nine) Released Today →
YARD 0.4.0 (codenamed The Whole Nine) was just released today. It’s by far the biggest release since I started writing YARD in 2007. For those who don’t know, YARD is a Ruby documentation tool…
Get Ruby 1.9, Rails, MySQL and UTF-8 to Work... →
Here’s a quick little hack to get MySQL 2.8.1 using UTF-8 in Rails 2.3.4 and Ruby 1.9.1.
Filename: lib/mysql_utf8.rb (or use the gist)
class Mysql::Result def encode(value, encoding = "utf-8")...
Ruby 1.9 Encoding Issues, Again. →
I covered Ruby 1.9 encodings a while back on my blog, but apparently I left out a few other major issues. I noticed these just recently, when running 1.9 on a new environment. It turns out,…
October 2009
6 posts
This is going to sound weird, but my background brings out the colour of my taskbar.
Who “Owns” Documentation? →
When you manage a software project, how do you delegate the task of documentation? This is something I’ve been thinking about for a while. Many projects deal with documentation at an ad-hoc basis….
At least he'd be good at English
L: wanna name our kid an anagram of lemonparty?
M: Marty Nople?
M: Marty Polen?
L: uh huh
M: both. okay.
This actually happened on the plane
E: My throat hurts...
L: Open your mouth and say "ahhh"...
E: Why?
L: I just want to see if it looks okay.
E: *Ahhhh* ... How does it look?
L: It looks fine.
E: *Looks satisfied and rests her head on my shoulder*
L: ...I'm not a doctor, by the way.
“And they say electricity can travel up your piss stream…”
– ♫ Why? — Against Me ♫ It’s off their new album Eskimo Snow
blamo
