=P
Section 2 sounds to me like it would be made of examples, maybe merged with 3?
I think it's worth spending a bit of time on the actual outline (e.g. bullet points on each section), before launching into writing, to avoid redundancy. We can do this directly on the github template. For example, I would add my chromosome finding example (with code) to the gallery/science applications.
Speaking of development practices, I've recently noticed that there's a bit of heterogeneity in the API, with some parts being object-oriented in style and others (most) being functional, which is my preference. Do we want to emphasise that this is the preferred style?
+1 for a roadmap section.
Juan.