RSpec patches

I totally fell in love with RSpec. Although I’m not really into BDD, I’ve found that RSpec makes my tests easier to read and easier to organize.

But their website really is a problem. Its navigation is pretty confusing. At first, I didn’t know that there are 3 more levels of pages under “Documentation” - I thought that the first page I see under “Documentation” is the only documentation available. This is because the navigation bar changes in ways that I think people would typically not expect. And their RDoc documentation looks horrible because it uses the default RDoc template.

Because they’re experimenting with Git since today, I decided to check out their sources and see whether I can contribute. I’ve redesigned their menu bar, and although it’s not perfect, it should be better than it currently is. Compare the current navigation with my redesign.

I’ve also submitted a patch for generating the RDoc documentation with my “Horo” RDoc template (which is based on the Jamis RDoc template). A sample can be found at: http://izumi.plan99.net/rspec-horo/

Hopefully these patches will get accepted.

Leave a Comment