David Ffrench I also sent a mail about this to aerogear google groups as well. I wanted to get some opinions/agreements about the approach to these types of documents as it should ideally be the same across all of our repos.