CFD Online Logo CFD Online URL
www.cfd-online.com
[Sponsors]
Home > Forums > OpenFOAM Announcements from Other Sources

CoCoons Project - Community-driven Documentation on OpenFOAM® Technology

Register Blogs Members List Search Today's Posts Mark Forums Read

Like Tree23Likes
  • 21 Post By holger_marschall
  • 2 Post By holger_marschall

Reply
 
LinkBack Thread Tools Display Modes
Old   June 28, 2013, 03:22
Default CoCoons Project - Community-driven Documentation on OpenFOAM® Technology
  #1
Senior Member
 
Holger Marschall
Join Date: Mar 2009
Location: Darmstadt, Germany
Posts: 122
Rep Power: 10
holger_marschall is on a distinguished road
Send a message via Skype™ to holger_marschall
If I can't find a reindeer, I'll make one instead.
- T. Grinch, 1957

Dear FOAMers,

I proudly announce

The CoCoons Project - Community-driven Documentation on OpenFOAM® Technology
www.cocoons-project.org

that has recently been launched!

CoCoons
  • is about the C++ programming language for Computational Continuum Numerics and its main principles: object orientation ('oo' in name), encapsulation (logo); code re-use, polymorphism and generic programming by inheritance and templated classes.
  • refers to self-contained ('encapsulated') documents embedded into an elaborated documentation framework - a modular approach to community-driven documentation of the OpenFOAM® CFD Toolbox for Computational Continuum Mechanics, which the project focuses on in a first step.

The CoCoons Project is essentially a team of experienced users (volunteers) with minimal central organization. It is hoped to establish a high quality system of documentation on OpenFOAM® Technology that is easy to use and search through.

All CoCoons documentation is freely available (incl. the source), licensed under the terms of the GNU Free Documentation License 1.3. CoCoons documentation is to be professionally published via partner publishing house and international journal (Elsevier) standing side by side with CoCoons Project. For more information please visit

--------------------
The basic idea ...
--------------------
The basic idea was to create a Joomla-based website (a professional content managed system for web content) for community-driven documentation on OpenFOAM® Technology. This is quite flexible and professional in terms of layout, extensions and administrations.

For typesetting CoCoons documentation we chose LaTeX - a high-quality typesetting system which includes features designed for the production of technical and scientific documentation, which is visually of high quality, consistent and clear appearance throughout, precise and concise. Using LaTeX templates along with an own LaTeX document class, style-file and macros specific for community-driven documentation on OpenFOAM® Technology, a professional layout is achieved for CoCoons documentation.

The CMS Joomla! as well as LaTeX are both inherent parts of the CoCoons Project. It is strongly believed that both "ingredients" are crucial for a monolithic, coherent and attractive handbook/guide system.

--------------------
The concept ...
--------------------
On the Website of the CoCoons Project, LaTeX-Templates are provided, that can be freely downloaded and modified, containing the current documentation status of
  • top-level utilities
  • top-level models
  • top-level solvers
as they come along with the OpenFOAM® releases or remixes. Accordingly, there is a CoCoons documentation download section where you can download
  • CoCoons Utility Guide to OpenFOAM® Technology
  • CoCoons Modeling Guide to OpenFOAM® Technology
  • CoCoons Solvers Guide to OpenFOAM® Technology
as pdf-files, which will be maintained and updated regularly.

IMPORTANT: Any modifications CANNOT be uploaded directly but have to be sent to a third-party reviewer resp. an expert of a special interest group (SIG). The reviewed document will be sent to an administrator of the CoCoons Project, who will then upload the contribution. The contributor and reviewer will be added to a list of authors and reviewers in the document. At the same time, the document version number will be increased accordingly.

In addition, CoCoons documentation shall include the hosting of a tutorial collection on OpenFOAM® Technology on this website.

--------------------
The Website ...
--------------------
For more details please visit ...

www.cocoons-project.org

... and keep FOAMing & contributing!


---
best regards
Holger Marschall

Disclaimer: This offering is not approved or endorsed by ESI® Group, ESI-OpenCFD® or the OpenFOAM® Foundation, the producer of the OpenFOAM® software and owner of the OpenFOAM® and OpenCFD® trademarks.

Cocoon® is a registered trade mark of the The Appache® Software Foundation (ASF). The above use has been officially approved by ASF within the scope of scientific computing. The author duly acknowledges the trademarks of ASF and refers to the official websites for Apache Cocoon (link).
__________________
Holger Marschall
web: http://www.holger-marschall.info
mail: holgermarschall@yahoo.de

Last edited by holger_marschall; June 28, 2013 at 05:42.
holger_marschall is offline   Reply With Quote

Old   July 2, 2013, 03:31
Default
  #2
Senior Member
 
Holger Marschall
Join Date: Mar 2009
Location: Darmstadt, Germany
Posts: 122
Rep Power: 10
holger_marschall is on a distinguished road
Send a message via Skype™ to holger_marschall
Dear FOAMers,

thanks for the many positive feedbacks. Via E-mail I have been asked the following and I want to use the forum to make the answers available to everyone in the community:
  • Assume I want to start documenting a utility, how do I know no body else is working on the same thing?

    As a part of the project, there is a site for monitoring documentation progress. Herein you find the categories 'Documents under Progress', 'Documents under Review' and 'Documents need Review' in order to avoid repetitive work. See http://www.cocoons-project.org/documentation-progress.

    For being listed please use the forms provided on the website to contact me: http://www.cocoons-project.org/howto-contribute

    Please follow the step-by-step instruction for contributions to the CoCoons Project provided in the FAQ section: http://www.cocoons-project.org/how-can-i-contributei

  • How can people of similar interest collaborate on the same project. One can think of an idea (involving Git) but I would like to know your approach?

    "Everything Should Be Made as Simple as Possible, But Not Simpler".
    It is my belief that a community-driven documentation effort should be as easy as possible in its workflow. Dealing with all specific cases and scenarios of collaborative/joint work on documentation would definitely be too much and confusing. This said, I really think it's up to you -- If you search for co-authors; how about opening a thread in this forum or on the discussion board of the Special Interest Group on OpenFOAM® documentation (link)? Want to use git: please check out bitbucket.org (it's great and free)?

Hope this is of help! In case of any questions, please don't hesitate to ask.

best regards,
Holger
__________________
Holger Marschall
web: http://www.holger-marschall.info
mail: holgermarschall@yahoo.de
holger_marschall is offline   Reply With Quote

Old   November 18, 2013, 02:50
Default Documentation Marathon on OpenFOAM
  #3
Senior Member
 
Holger Marschall
Join Date: Mar 2009
Location: Darmstadt, Germany
Posts: 122
Rep Power: 10
holger_marschall is on a distinguished road
Send a message via Skype™ to holger_marschall
Dear FOAMers,

The CoCoons Project on community-driven documentation of the OpenFOAM® CFD Toolbox has started some time ago. Thanks a lot for all your positive feedbacks and input to the project!

As a kick-off I now want to announce the
Documentation Marathon on OpenFOAM® over winter/spring 2013/14
The goal of this campaign is to launch The CoCoons Project, to get it off the ground and to provide the ideal setting for free high quality documentation on OpenFOAM® Technology.

To have a free high quality documentation system for OpenFOAM® is a big vision, and it will require YOUR help to make it happen! Please contribute. The CoCoons Project is a community project: we need your contributions, so don't be afraid to jump in! All high-quality contributions will be published (see CoCoons Project's Partners and CoCoons Project FAQ).

And as a must-have for a real Marathon, crossing the finish line in 1st of April 2014 there are rewards waiting for you, of course:

Every FOAMer who submits
  • 1000 words of documentation on OpenFOAM®'s utilities, models and solvers wins a CoCoons Project T-Shirt
  • 2500 words of documentation on OpenFOAM®'s utilities, models and solvers wins a CoCoons Project Polo-Shirt
sponsored by Engys Ltd. (Eugene de Villiers). Thanks a lot!

For more details have a look at

www.cocoons-project.org

... Have fun and KEEP FOAMing!

best regards,
Holger Marschall

CoCoons Project
contact@cocoons-project.org
philippose and wyldckat like this.
__________________
Holger Marschall
web: http://www.holger-marschall.info
mail: holgermarschall@yahoo.de
holger_marschall is offline   Reply With Quote

Old   December 13, 2013, 10:14
Default Update - Documentation Marathon on OpenFOAM
  #4
Senior Member
 
Holger Marschall
Join Date: Mar 2009
Location: Darmstadt, Germany
Posts: 122
Rep Power: 10
holger_marschall is on a distinguished road
Send a message via Skype™ to holger_marschall
Dear FOAMers,

I am happy to inform that the community-driven documentation effort of OpenFOAM® technology

The CoCoons Project - Community-driven Documentation on OpenFOAM® Technology
www.cocoons-project.org

takes quite some momentum: recently, the Documentation Marathon on OpenFOAM® over winter/spring 2013/14 has been started. For more information please read the corresponding post in this thread. Now, the category "Documentation Progress" has been updated. Have a look at

Updated section - CoCoons Documentation Progress
http://www.cocoons-project.org/documentation-progress

All professional contributions shall be published in book form! Consider contributing early and share your expertise! Keep FOAMing!

For more information start from the project's FAQ section:
  1. Why contribute?
  2. How to contribute?
  3. CoCoons Project Partners

best regards,
Holger Marschall

CoCoons Project
contact@cocoons-project.org
__________________
Holger Marschall
web: http://www.holger-marschall.info
mail: holgermarschall@yahoo.de
holger_marschall is offline   Reply With Quote

Reply
Thread Tools
Display Modes

Posting Rules
You may not post new threads
You may not post replies
You may not post attachments
You may not edit your posts

BB code is On
Smilies are On
[IMG] code is On
HTML code is Off
Trackbacks are On
Pingbacks are On
Refbacks are On


Similar Threads
Thread Thread Starter Forum Replies Last Post
The FOAM Documentation Project - SHUT-DOWN holger_marschall OpenFOAM 242 March 7, 2013 13:30
Doxygen documentation Tanay OpenFOAM Installation 9 September 23, 2011 11:40
The FOAM Documentation Project holger_marschall OpenFOAM Announcements from Other Sources 0 October 12, 2009 14:16


All times are GMT -4. The time now is 04:52.