Add note about naming conventions
Adhere to a single naming convention

+ name is only used for url names
+ display_name is used for normal human readable names
+ Apiary is updated
+ Close #308