Documentation - be more specific for new users


(Paul) #1

I have just started using Gradle and have been working through your online tutorial.

I think you should make it explicit very early on in the About Gradle (Section 1) that the chapters in Section 2 “Working with existing builds” are deliberately abstract, dealing in concepts and that the “HOW TO” material is coming up in Section 3.

I more or less gave up at chapter 8 when it started talking about Multi-Project builds with no details of how you would define such a thing. Rereading the table of contents, I now realise that Section 2 is about “Existing Builds” but I didn’t get the implication of that at the time.

Can I suggest adding something in the Intro that new users might like to jump straight to Section 3/Chapter 14 first?