← Back to team overview

fenics team mailing list archive

Re: Demo documentation

 



On 27/04/10 10:11, Kristian Oelgaard wrote:


On 27 April 2010 10:50, Garth N. Wells <gnw20@xxxxxxxxx> wrote:
I'm wondering if it's appropriate to separate the documentation for demos
into C++ and Python versions since a good fraction is common. We could
combine it into one file, or split into three (rather than the two
which we
have now) with

I think it is a matter of taste.

My point is not so much taste, but how best to avoid duplication. How can we best avoid duplicating the description of the equation and method?

Garth

I was thinking that we could have the
common text in separate *.rst files and then include them where
appropriate in the C++ and Python specific files. Such that we have (in
the demo dir):
common/*.rst
cpp/*.rst
python/*.rst

With this approach it will be possible to print a self contained version
for either C++ or Python. It might not be very interesting for the
demos, but the Tutorial and Programmer's reference could benefit from
this approach.

Kristian

1. Problem and method description
2. Documentation of C++ demo code
3. Documentation of Python demo code

Garth

_______________________________________________
Mailing list: https://launchpad.net/~fenics
Post to     : fenics@xxxxxxxxxxxxxxxxxxx
Unsubscribe : https://launchpad.net/~fenics
More help   : https://help.launchpad.net/ListHelp





Follow ups

References