joelbyler/intro_to_rails_on_cloud9

Feedback

Opened this issue · 0 comments

Hey Joel,

I went through the tutorial, and have a little bit of feedback. Overall it's great! I love the examples in rails console, and the pace seems good. I've got a couple minor things that might be confusing or stumbling points, though. C9 is cool. I went through the tutorial on an iPad, which was kind of mind blowing. I wouldn't recommend it yet, though. The arrow keys don't work on a Bluetooth keyboard, and you sometimes lose focus on the editor pane.

General

  • Would it be useful to commit more often? Could save time troubleshooting problems to be able to git reset and try a step again.
  • It would be nice to have a little more background about what a database is, since many of the explanations rely on that knowledge (displaying database information, updating the database, migrating the database)
  • Steps that update topics/index.html.erb should update the col-span in the table header. This is trivial though, and might add unnecessary confusion.

Getting Started
The table explaining the main rails directories contains a lot of buzz words and may be overwhelming.

Setting the Default Page
I liked the explanation of rake routes, but it was unclear that they came from the resource line in routes.rb. Also, an explanation that topics#index came from the listed routes would be helpful.

Voting on Topics
(Trivial)
It's not clear that the rails generate and rake commands are two separate commands.

Allow People to Vote
It's unclear why the new route is being nested inside the resources block.