The latest user guide (for Gradle 0.6) includes the name of the file, plus > its location in the samples dir, in the title of each sample. For example > have a look at the new multi-project builds chapter: > > http://gradle.org/userguide/latest/multi_project_builds.html > > (I'm not 100% happy with the format for the captions, but I think they are > an improvement) > > Is this the sort of thing you were thinking of? >
That's much better but I'd prefer it to be just 'water/settings.gradle' (i.e. without the leading 'userguide/multiproject/firstExample/'). When I'm reading the documentation I'm really only interested in relative path of the file (i.e. it's settings.gradle file in the project root); the full path on every snippet obscures this. The actual location of the example is useful, but I think it would be better stated once in a note at the beginning of the example or something (e.g. 'For detailed examples please see 'userguide/multiproject/firstExample'). Cheers Andrew
