On Wed, Nov 20, 2013 at 3:19 PM, Juan Nunez-Iglesias email@example.com wrote:
@stefanv, I've found a flaw in your structure:
I don't quite get the joke (doh).
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.
Sure, make a few suggestions here then we can pen down the outline.
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?
I think the majority of the library consists of functions, unless there is a big benefit to doing it differently. Can you elaborate?
Stéfan van der Walt