Minor README improvements.

- Remove defunct TODO about linking to API docs.
- Use ERB language identifier for code blocks where appropriate.