This spec describes how we might improve the Gradle documentation and the generation of this documentation. 
This includes the Gradle userguide, The DSL Reference and the Java/Groovydoc.

# Use cases

## DocumentationRegistry should check/validate generated links 

## DSL generation should handle methods inherited from superinterfaces
Add spec for docs improvement.
REVIEW-2050: Add spec for docs improvement.
