Resource conventions and examples

[teehill]

1. Should @id values contain version numbers, and if so let's specify and update the examples.
2. Should resource names always be pluralized? If so let's specify explicitly.