[vtkusers] Examples organization for multiple languages

Jeff Baumes jeff.baumes at kitware.com
Mon Feb 1 09:22:59 EST 2010


On Fri, Jan 29, 2010 at 4:56 PM, David Doria <daviddoria+vtk at gmail.com> wrote:
> Anders has been translating some of the c++ examples on the wiki into
> Python (thanks!!).
>
> I originally organized the examples to have a separate Python section
> mainly because I am not really a Python programmer so I only had a
> couple of things in the category. If the Python section is headed
> towards growing as large as the c++ section, the question has come up
> should we have the examples integrated under one table of contents
> regardless of language, e.g.
>
> Geometric Objects
> -------------
> Line (c++)
> Line (Python)
> Sphere (c++)
> Sphere (Python)
>
> Or should the separate Python section remain, e.g.
>
> C++
> --------
> Geometric Objects
> --------------------
> Line
> Sphere
>
> Python
> ----------
> Geometric Objects
> -----------------------
> Line
> Sphere
>
> Any thoughts?

A reasonable approach might be to put both C++ and Python code on the
same page if it does the exact same thing. It seems that would be good
for maintenance too. If someone corrects/improves the example in one
language, they can correct the other on the same page at the same
time.

Jeff



More information about the vtkusers mailing list