Off the Rails

Five years, a dozen production apps, and I'm losing the faith.

September 30, 2013 at 2:15pm

Here are some normally hidden yet very useful rake tasks. Why hidden? Because they’re not documented. And rake hides undocumented tasks by default.

Here are some normally hidden yet very useful rake tasks. Why hidden? Because they’re not documented. And rake hides undocumented tasks by default.

September 26, 2013 at 9:22am

Python has wonderful things like docstrings and help(), as well as a community that values documentation so much they actually write it. Write documentation? Willingly? Crazy, I know, but it really spoils you.

— James Pearson

September 24, 2013 at 3:01pm

The Ruby 2.1 release notes … didn’t go too much into detail. To find out more, you are pretty much left with diving through the Ruby issue tracker.

— Konstantin Haase

September 20, 2013 at 5:53pm

A page full of irrelevant ads and links to deprecated software. That’s what you get when you search in the official Ruby API. 

A page full of irrelevant ads and links to deprecated software. That’s what you get when you search in the official Ruby API

September 17, 2013 at 4:13pm

Ruby on Rails Core List →

The official Rails site points here for the core dev discussion. But the group is moribund: half the posts have no reply. Very low traffic. I couldn’t find any posts by core devs.

Is core dev conversation held in private only? Have I missed something?

1:48pm

My rageful Ruby/Rails realization of the day:

  1. Create a new Rails app
  2. Follow the link to documentation
  3. Get a 404.

Bonus annoyance points for (a) this being an API page, (b) the lack of creating a redirect, and (c) the implied lack of caring and respect for app developers.

September 13, 2013 at 6:25pm

The new Ruby 2 “named parameter” feature … isn’t documented

— My rageful Ruby/Rails realization of the day

5:59pm

Good memories: a Python app I wrote, circa 2003.

Good memories: a Python app I wrote, circa 2003.

August 20, 2013 at 12:00am

Getting fed up with the state of Ruby and Rails documentation

As long as I’ve known about Python, there’s been;

  1. a canonical home page (python.org), with
  2. one single easy-to-see Documentation nav link. And finally,
  3. at the top of the Documentation page, there are two docs that answer 99% of questions about the language: Tutorial (which is really a complete language guide), and Library Reference. 
So e.g. info on “how to create a class” is easy to find in the Python world: Tutorial / Classes.

There isn’t a comparable doc for ruby.