@rmanalan

Colin and his ice cream

Posted

Meet the newest member of our family, Lucy!

She's a black english labrador retreiver... 7 1/2 weeks old.  We absolutely love her!

Posted

How to use an iPhone to Fly R/C Airplanes and Helicopters

Awesome! Would love one of these toys. Not going to be long now before someone rigs up a regular RC plane to use an iPhone as a controller.

Posted

I'm standing up to be counted

Background from Nick Sieger and here. I was there and I saw Matt's presentation. The relevant portion of his presentation was good (CouchDB). However, the porn references were disturbing and made me wonder how the rest of the audience felt at that time -- especially the handful of women who attended. There were definitely some DHH types in there that liked his style and the porn references, but there were definitely people disturbed by it.  I'm one of them. I'm not going to spend too much time hashing out why it was a bad idea... that's obvious.  I just want it to be known that there are a lot of people in the Ruby and Rails community that don't think like DHH.  While I can respect his stance on this topic, I can't say it's very helpful to anyone when he advertises it.  It's terrible enough that there's a large gender inequality in our profession.  Incidents like this make it worse. With that said, I hope that we can all move on soon and try to make this community more accepting to women.
Posted

CameraBag photo

Testing out CameraBag

Posted

A Visual Guide to Inflation

Mint.com's blog is very educational. Their latest visual guide to inflation is a good primer on what maybe next in our financial crisis. Props to Mint.com and WallStats.com

Posted

zsh-templates-osx

Posted

SaveIE6: Help us save the best browser around

I love it. Finally IE6 fights back!

Posted

If bit.ly Is Worth $8 Million, TinyURL Is Worth At Least $46 Million

Unbelievable that bit.ly can raise $2m (and valued at $8m) -- ridiculous! It's a freakin URL shortner for gawd sakes!

Posted

Introducing Bdoc: A Better Gem Doc Browser

Install: [sudo] gem install manalang-bdoc
Usage:
shell> bdoc
GitHub:
http://github.com/manalang/bdoc/tree/master
Demo:
http://manalang.com/bdoc

I love APIdock.  I also love gotAPI.  And I think that api.jquery.com is pretty nice.  However, they all require an internet connection.

Over the last few weeks, there have been some progress in making Ruby/Rails documentation better specifically for those times when you're disconnected.  The first noteworthy ones are the Ruby and Rails dictionaries for OS X. This makes it possible to access Ruby/Rails doc through OS X' spotlight.  This is a pretty cool solution that I use quite a bit.  The next improvement is called Hanna and is a major improvement to the basic Rdoc template -- it also sports a nice method filter that makes it easy to look up class methods.  Last week, I heard about the Rails Searchable API Doc (aka, sdoc) which makes it possible to do super-fast searches much like APIdock.  The only problem with the OS X dictionaries and sdoc is that they only include Ruby/Rails (Rails only for sdoc).

What I wanted was something that ties together all of the existing Rdocs I already have on my computer.  Gem Server allows you to view all of your locally installed gems, but:
  1. The UI sucks.
  2. Once you pick a doc to view, there's no way to go back to the main index without hitting the back button.
  3. You have to run a server to view local static files.
I wanted something better -- something that makes it easy to browse my entire collection and easily navigate from one Rdoc to another and not force me to run a server.  So, I decided to scratch my own itch... the result is Bdoc. Before Bdoc, I used the gemdoc bash alias that makes it easy to access my gem Rdocs from the command line.  I wanted something similar to gemdoc since most of the time is spent in the command line.

All Bdoc does is create an index of all the gems you have installed that have Rdocs and creates a nice one page file that allows you to browse all of these Rdocs.  Here's an example: http://manalang.com/bdocs.  All you have to do is type in "bdocs" in your command line and voila, you've got all your gem docs in your favorite browser.  Bdocs doesn't require a server because it just opens the generated index.html in your browser using the file:/// protocol.

Here are some improvements I'd love to add in someday (unless someone forks it and does it for me :-)):
  • Patch or fork Hanna to generate a json index of all the classes and methods for each gem.  This will make it possible to generate a method/class search filter much like the one sdoc provides.
  • Add in Ruby Rdocs.  I haven't figured out how to generate the Ruby core and Ruby standard lib Rdocs (and to see if OS X comes with it already installed).  If so, I'd love to add this to the Bdoc index.
  • Possibly make the gem listing a bit easier on the eyes.  If you have a huge list of installed gems, the gem listing can be a bit scary.
Give it a try and let me know what you think.

     

Posted