improve comments, move target documentation to top for 'head build.gradle'