Peter Alexander wrote: > Considering the api is not dominant to Cython users, reST inlined with > the code source is not the right approach.
Well, the examples are there to present Cython code. I don't see how this makes inlined code the wrong approach. It even has the advantage of allowing to split the code around explanatory text sections. The only problem I see is that it's harder to test as doctest doesn't currently work for Cython code. But that could be helped by extracting the code from the document into a module first. The problem I see with an MVC approach (I assume you considered writing the example code with text injection hooks) is that they'd loose the context. The examples don't make much sense without the surrounding text that explains what's interesting about them. And if they do, they may not be good examples in the first place, as they're likely too broad. Stefan _______________________________________________ Cython-dev mailing list [email protected] http://codespeak.net/mailman/listinfo/cython-dev
