Add bit about documentation style to CONTRIBUTING

A bit about the preferred style of documentation. See https://groups.google.com/d/msg/elixir-lang-core/40vwemfdE6Q/WjLgS7d4mtsJ