On 16. mai 2011, at 14:17, Kristian Ølgaard <k.b.oelga...@gmail.com> wrote:

> On 16 May 2011 13:49, Marie E. Rognes <m...@simula.no> wrote:
>> 
>> 
>> On 16. mai 2011, at 12:13, "Garth N. Wells" <gn...@cam.ac.uk> wrote:
>> 
>>> I suggest now would be a good point to make new releases of UFL, FFC and
>>> DOLFIN. There have been a number of improvements to UFL, FFC caching,
>>> and there have been a good number of DOLFIN bugs fixes. New version
>>> numbers would be:
>>> 
>>> UFL: 0.9.1
>>> FFC: 0.9.1
>>> DOLFIN: 0.9.12
>>> 
>>> Jump in quick if there is anything that you would like do before a release.
>>> 
>> 
>> I have one thing relating to the documentation, and the demo documentation 
>> in particular.
>> 
>> In order to more easily keep the demo documentation in sync with the demos, 
>> I think we should move the .rst files from the separate fenics-doc repo to 
>> the corresponding dolfin demo directories. Any objections?
> 
> Yes, the whole point of fenics-docs was to collect the documentation
> in one place, thus separating the documentation from the packages
> containing the code.
> 

I understand that point, but I don't see it working that well. 

Having the demo .rst files with the dolfin demos would (a) make it more obvious 
to update them when updating the code and (b) make it easier to ensure valid 
documentation for stable releases. 

Wasn't the API documentation for the DOLFIN library moved in with the code for 
some of the same reasons? 

Writing documentation isn't that fun, so I would like to aim for a system that 
is maintainable. 

--
Marie


> Kristian
> 
>> (I'm on very flaky wifi until Wednesday morning and at the moment slightly 
>> unable to do anything but occasionally retrieve email...)
>> 
>> --
>> Marie
>> 
>> 
>>> Garth
>>> 
>>> _______________________________________________
>>> Mailing list: https://launchpad.net/~ffc
>>> Post to     : ffc@lists.launchpad.net
>>> Unsubscribe : https://launchpad.net/~ffc
>>> More help   : https://help.launchpad.net/ListHelp
>> 
>> _______________________________________________
>> Mailing list: https://launchpad.net/~ffc
>> Post to     : ffc@lists.launchpad.net
>> Unsubscribe : https://launchpad.net/~ffc
>> More help   : https://help.launchpad.net/ListHelp
>> 

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

Reply via email to