Definitely possible. I'm the lone technical writer for Gradle, and I only started rather recently, but this is absolutely on my radar. I'm hoping to make some changes related to this the coming weeks and months -- I just don't want to be TOO hasty in making giant docs changes. Stay tuned for development on this soon, and thanks for the suggestion!