Hi Dominik, On Wed, Jan 8, 2014 at 11:34 AM, Dominik Süß <[email protected]> wrote: > ...Good inline documentation is really good to understand why things behave as > they behave, But you need some guidance when starting with a new > technology. I think there is also some room to flatten this initial > learning curve by having some documentation/tutorials and/or "guided" > demoprojects....
Yes, and one of the goals of the samples/mail-archive app is to be one of those tutorials. Still needs work. What I mean with using readable tests as reference documentation is that detailed docs tend to go stale. I'd much rather stick to overview docs that explain the general principles, avoid too many details and especially copy/pasted code in docs, and point to tests for the details. -Bertrand
