[Developers] Save the date - June 20 - 23, 2011

[Hans Julius Skaug]

John,

Yes, it seems that doxygen also does the higher level 
documentation (I looked at the KDE example), which
means that we can stick to a single system for documentation, 
which is good.

What then remains is a discussion about contents and structure ...

Hans

________________________________________
From: John Sibert [sibert at hawaii.edu]
Sent: 04 February 2011 18:11
To: Hans Julius Skaug
Cc: 'developers at admb-project.org'
Subject: Re: Save the date - June 20 - 23, 2011

Hi Hans,
Good suggestion. I don't know what alternative documentation tools might
be available (other than TeX). Doxygen is pretty extensible and can be
used to build entire websites. There are examples on
http://www.doxygen.org/index.html. The "Main Page " on the ADMB api dox
is a file specifically created to contain the text you see as well as
the description sections of the modules on the "Modules" tab. Also some
of the capabilities of Doxygen have not been activated such as graphical
representation of class hierarchies.

In short, if we know what we wanted to include in the "big picture" we
could probably do it pretty easily. So, the challenge is to know exactly
what to include. Any ideas anyone?
John

On 02/04/2011 05:06 AM, Hans Julius Skaug wrote:
> Hi John,
>
> One suggestion for an agenda point:
> - is there a need for higher (than Doxygen) level documentation?
>
> The background is that it is difficult to see the big picture (design principles)
> from the code/doxygen. I do not know if a similar level
> of docs exists in other software projects.
>
> On the other hand, I am aware that that much work remains on
> the doxygen stuff, so it may not be a good idea to start talking
> about other types of documentation.
>
> Hans
>
>
>
>> -----Original Message-----
>> From: users-bounces at admb-project.org
>> [mailto:users-bounces at admb-project.org] On Behalf Of John Sibert
>> Sent: Monday, January 03, 2011 6:55 PM
>> To: developers at admb-project.org; users at admb-project.org
>> Subject: [ADMB Users] Save the date - June 20 - 23, 2011
>>
>> Colleagues,
>>
>> Apologies for duplicate posting.
>>
>> I'm pleased to announced that we have finally been able to
>> organize our
>> first ADMB Developers' Workshop. It will be held at the
>> National Center
>> for Ecological Analysis and Synthesis in Santa Barbara,
>> California, June
>> 20 - 23, 2011. We also have limited funding available to assist with
>> travel and participation.
>>
>> At this point, the workshop agenda and format are completely
>> open. Some
>> of the topics that have been suggested include writing adjoint code,
>> parallelization, R interfaces, installation packages, ... .
>> Others have
>> suggested breaking into small groups to implement specific
>> features (but
>> which ones).
>>
>> So my purpose in writing to invite you to participate, to solicit
>> suggestions for workshop topics, and to find the names of others who
>> might make a substantive contribution to the proceedings.
>>
>> Cheers,
>> John
>>

--
John Sibert
Emeritus Researcher, SOEST
University of Hawaii at Manoa

Visit the ADMB project http://admb-project.org/