Difference between revisions of "Main Policy"

From OpenFOAMWiki
m (Semantic conventions)
m
Line 51: Line 51:
 
==== Code snipplets ====
 
==== Code snipplets ====
  
=== Ettiquete ===
+
=== Etiquette ===
 +
 
 +
This section is of course not necessary, because CFD-people are widely known for their good manners and their sensitivity, but I'll write it anyway:
 +
 
 +
* be polite
 +
* if an article is signed with a name then only change it after checking with the author
 +
* comment the quality of an article only in the attached discussion-page (an be polite)
 +
* when using the work of others in a signed article make it clear where you got it from
  
 
== Technical conventions ==
 
== Technical conventions ==
  
 
TODO: naming of pages, etc
 
TODO: naming of pages, etc
 +
 +
 +
--[[User:Bgschaid|Bgschaid]] 13:48, 31 May 2005 (CEST)

Revision as of 11:48, 31 May 2005

This page gives an overview of the conventions in this Wiki.

1 Information submitted to this Wiki

TODO: License etc

The information in this Wiki is under the GNU Free Documentation License. This is the same license as the one used for the OpenFOAM manuals.

For more details and to learn about the consequences go to Project:Copyrights.

Please don't publish anything you don't have the rights for here. When in doubt include only a link to the material.

2 Semantic conventions

The general rule is:

  • structure the information in this Wiki in the same way it is structured in the OpenFOAM distribution
    • The sections for solvers and other applications should have subsections that mirror the directory structure of their sources
    • The annotations to the manuals are organized in a structure that mirrors the chapters of the printed versions
  • use the same nomenclature as the printed OpenFoam documentation (especially for symbols)

Reference the original source of information. One special case is if your source is a discussion from the OpenFOAM-message board: put a link to that discussion into your article.

2.1 What goes where

The main part of this Wiki is the FAQ. Therefor this section will explain what doesn't go into the FAQ, where it goes and why.

The basic rule is: the FAQ only should have articles that

  • are of general interest (more than 3 persons have already asked that question or expressed interest in the answer)
  • can be formulated as a short, precise questions
  • can be answered in a few sentence

Therefor the exceptions are:

  • if the question is about a solver or a utility and the answer is only applicable to that application then write it in the article in Solvers or Utilities
  • if the answer is too long consider writing an article in one of the categories (and reference that article in the FAQ. Too long would mean (these numbers are only approximations):
    • More that 10 lines of C++-code (consider writing a Code Snipplet)
    • More than 10 lines of text (consider writing in Tips and Tricks or [main_HowTos|the How-Tos]])


2.2 Information on the pages

TODO: Which information should go on which page type

2.2.1 Application pages

2.2.2 User pages

2.2.3 Project pages

2.2.4 Code snipplets

2.3 Etiquette

This section is of course not necessary, because CFD-people are widely known for their good manners and their sensitivity, but I'll write it anyway:

  • be polite
  • if an article is signed with a name then only change it after checking with the author
  • comment the quality of an article only in the attached discussion-page (an be polite)
  • when using the work of others in a signed article make it clear where you got it from

3 Technical conventions

TODO: naming of pages, etc


--Bgschaid 13:48, 31 May 2005 (CEST)