CFD Online Logo CFD Online URL
www.cfd-online.com
[Sponsors]
Home > Wiki > Help:Contents

Help:Contents

From CFD-Wiki

(Difference between revisions)
Jump to: navigation, search
(Style guide)
Line 1: Line 1:
-
==General guidelines for editors==
+
==General guidelines for contributors==
-
* '''The Wiki needs your help!'''
+
This Wiki will never be better than the information we all fill it with. Everyone with some knowledge about CFD can contribute, so please go ahead and add something about your area of expertise. Things can always be improved later on! It is much better with a short incomplete page on something than no page at all. An incomplete page will encourage others to work further on it. So add whatever you can and leave it to others to improve it later on.
-
:This Wiki will never be better than the information we all fill it with. Everyone with some knowledge about CFD can contribute, so please go ahead and add something about your area of expertise. Things can always be improved later on! It is much better with a short incomplete page on something than no page at all. An incomplete page will encourage others to work further on it. So add whatever you can and leave it to others to improve it later on.
+
 
 +
=== Content policies ===
 +
 
 +
This Wiki tries to follow the [http://en.wikipedia.org/wiki/Wikipedia:Policies_and_guidelines policies and guidelines established by WikiPedia]. The most important content policies are:
* '''Write in a neutral point of view'''  
* '''Write in a neutral point of view'''  
-
:See the [http://en.wikipedia.org/wiki/NPOV WikiPedia NPOV definition]. This is especially important when writing about commercial products. We don't want a Wiki filled with commercial advertising.
+
:All articles should be written without bias, representing different views fairly. The Wiki is not the place to promote or advocate different point of views. Neither is it the place to promote yourself, a certain product or a company. Be very restrictive when writing about yourself, your company, your products or your own research results. See the [http://en.wikipedia.org/wiki/NPOV WikiPedia NPOV definition] for more information. This principle is especially important when writing about commercial products. We don't want a Wiki filled with commercial advertising.
 +
 
 +
*'''Do not publish original research in the Wiki'''
 +
:All material added to the Wiki should be established view or facts that are generally accepted in the research community. New research results should be published in peer-reviewed journals and conferences before you add it to the Wiki. For more information see [http://en.wikipedia.org/wiki/Original_research WikiPedia's page on original resarch].
-
* '''Please make sure that all material you add is free from any copyrights.'''
+
*'''Verifiability'''
 +
:Information in the Wiki should be verifiable, that is it should already have been published by a reputable publisher. Whenever possible include links or references where the information can be verified. Note that information does not necessarily have to be the one single truth - confliciting opinions might exist. For more information about the principle of verifiability see the [http://en.wikipedia.org/wiki/Wikipedia:Verifiability WikiPedia article on verifiablity].
-
* '''Check the style guide below'''
+
*'''No copyright violations'''
 +
:Please make sure that all material that you add is free from any copyrights. Do not add material to which others own the copyrights without their approval. We take copyrights seriously and will delete any material that is found to break someones copyrights.
-
== Style guide==
+
===Style guide===
-
This Wiki has just been started so we don't have any well-established common style yet.
+
In order to maintain a common style and format throughout the Wiki please try to follow the guidelines listed below. If you want to suggest new guidelines or discuss formatting issues please post a message on the [http://www.cfd-online.com/Forum/wiki.cgi Wiki forum].
-
However, below are a few recommendations that we seem to agree on so far. Feel free to add
+
-
your own recommendations here, or post a suggestion on the [http://www.cfd-online.com/Forum/wiki.cgi Wiki forum] if you want to discuss it.
+
-
=== Naming pages/articles ===
+
==== Naming pages/articles====
*Name pages with lower-case letters on all words except the first character.  
*Name pages with lower-case letters on all words except the first character.  
*Make sure that the page-name fully identifies the content. For example don't name a page on how to create movies with Fluent "create movies". Instead call it something like "Fluent - how to create movies". You can still link to it with a shorter link-title by using a piped link like this: <nowiki>[[Fluent - how to create movies | create movies]]</nowiki>
*Make sure that the page-name fully identifies the content. For example don't name a page on how to create movies with Fluent "create movies". Instead call it something like "Fluent - how to create movies". You can still link to it with a shorter link-title by using a piped link like this: <nowiki>[[Fluent - how to create movies | create movies]]</nowiki>
*Do not start page titles with ''The''. For example ''The Navier-Stokes equations'' should be only ''Navier-Stokes equations''.
*Do not start page titles with ''The''. For example ''The Navier-Stokes equations'' should be only ''Navier-Stokes equations''.
-
=== Mathematical formulae ===
+
====Mathematical formulas====
   
   
-
* Write mathematical formulae indented with a ":" in the following way:
+
* Write mathematical formulas indented with a ":" in the following way:
<pre>
<pre>
<nowiki>
<nowiki>
Line 31: Line 37:
</pre>
</pre>
-
* In pages with many formulae which you need to reference in the text number the formulae using a HTML table like this:
+
* Try to avoid numbering your equations and instead reference them in the text by their names. However, if you find it absolutely necessary to number your formulas please use a HTML table like this:
<pre>
<pre>
<nowiki>
<nowiki>
Line 61: Line 67:
</math>
</math>
-
===References===
+
====References====
Write references to publications in the following way:
Write references to publications in the following way:
Line 108: Line 114:
* '''ISBN numbers:''' For publications that have ISBN numbers make sure to include these in the "rest" parameter using the format "ISBN 1234567890" (see book example above). If you do this the Wiki will automatically hot-link the ISBN to online book-stores.
* '''ISBN numbers:''' For publications that have ISBN numbers make sure to include these in the "rest" parameter using the format "ISBN 1234567890" (see book example above). If you do this the Wiki will automatically hot-link the ISBN to online book-stores.
-
==Help with editing==
+
====Stubs====
 +
 
 +
foo bar
 +
 
 +
==Editing help==
For some basic help on how to edit pages please visit [http://meta.wikimedia.org/wiki/Help:Editor WikiMedia Help for Editors] or [http://en.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page How to edit a page]. For help with writing mathematical formulae, see the [http://en.wikipedia.org/wiki/Help:Formula wikipedia help pages].
For some basic help on how to edit pages please visit [http://meta.wikimedia.org/wiki/Help:Editor WikiMedia Help for Editors] or [http://en.wikipedia.org/wiki/Wikipedia:How_to_edit_a_page How to edit a page]. For help with writing mathematical formulae, see the [http://en.wikipedia.org/wiki/Help:Formula wikipedia help pages].

Revision as of 13:44, 4 November 2005

Contents

General guidelines for contributors

This Wiki will never be better than the information we all fill it with. Everyone with some knowledge about CFD can contribute, so please go ahead and add something about your area of expertise. Things can always be improved later on! It is much better with a short incomplete page on something than no page at all. An incomplete page will encourage others to work further on it. So add whatever you can and leave it to others to improve it later on.

Content policies

This Wiki tries to follow the policies and guidelines established by WikiPedia. The most important content policies are:

  • Write in a neutral point of view
All articles should be written without bias, representing different views fairly. The Wiki is not the place to promote or advocate different point of views. Neither is it the place to promote yourself, a certain product or a company. Be very restrictive when writing about yourself, your company, your products or your own research results. See the WikiPedia NPOV definition for more information. This principle is especially important when writing about commercial products. We don't want a Wiki filled with commercial advertising.
  • Do not publish original research in the Wiki
All material added to the Wiki should be established view or facts that are generally accepted in the research community. New research results should be published in peer-reviewed journals and conferences before you add it to the Wiki. For more information see WikiPedia's page on original resarch.
  • Verifiability
Information in the Wiki should be verifiable, that is it should already have been published by a reputable publisher. Whenever possible include links or references where the information can be verified. Note that information does not necessarily have to be the one single truth - confliciting opinions might exist. For more information about the principle of verifiability see the WikiPedia article on verifiablity.
  • No copyright violations
Please make sure that all material that you add is free from any copyrights. Do not add material to which others own the copyrights without their approval. We take copyrights seriously and will delete any material that is found to break someones copyrights.

Style guide

In order to maintain a common style and format throughout the Wiki please try to follow the guidelines listed below. If you want to suggest new guidelines or discuss formatting issues please post a message on the Wiki forum.

Naming pages/articles

  • Name pages with lower-case letters on all words except the first character.
  • Make sure that the page-name fully identifies the content. For example don't name a page on how to create movies with Fluent "create movies". Instead call it something like "Fluent - how to create movies". You can still link to it with a shorter link-title by using a piped link like this: [[Fluent - how to create movies | create movies]]
  • Do not start page titles with The. For example The Navier-Stokes equations should be only Navier-Stokes equations.

Mathematical formulas

  • Write mathematical formulas indented with a ":" in the following way:

:<math>LaTeX formula goes here</math>

  • Try to avoid numbering your equations and instead reference them in the text by their names. However, if you find it absolutely necessary to number your formulas please use a HTML table like this:

<table width="100%">
<tr><td>
:<math>
LaTeX for formula one goes here
</math>      
</td><td width="5%">(1)</td></tr>

  • For definitions and equivalences use "\equiv" (<math>\equiv</math>) and use "=" (<math>=</math>) for equations.
  • If you want to put some text within an equation, use the \mbox{} environment. For example

:<math>
\epsilon_{ijk} = 1, \mbox{ if all i, j, k are different and in cyclic order}
</math>

will produce


\epsilon_{ijk} = 1, \mbox{ if all i, j, k are different and in cyclic order}

References

Write references to publications in the following way:

  • Placement: Place references in the article in which they are used, either in a ==References== section at the end or, if it is a very long article, in the section where the reference is used. If it is a long article you might also consider splitting it into smaller articles.
  • Order: Order references alphabetically based on the name of the first author
  • Numbering: If you want to number the references use square bracket like this: [1]
  • Names: Write author names as "Lastname1, Firstname1 and Lastname2, Firstname2"
  • Style: There are two different templates which you should use for references - the reference-paper template for scientific publications like journal articles, theses, etc. and the reference-book template for books. The two examples below illustrate how these templates should be used in the Wiki:

{{reference-paper|author=Granville, P. S.|year=1987|title=Baldwin-Lomax Factors for Turbulent
Boundary Layers in Pressure Gradients|rest=AIAA Journal, Vol. 25, No. 12, pp. 1624-1627}} 

{{reference-book|author=Batchelor, G. K.|year=2000|title=An Introduction to Fluid
Dynamics|rest=ISBN 0521663962, 1st Edition, Ch. 5.7 Boundary Layers, pp.303}} 

These two references would look like this:

Granville, P. S. (1987), "Baldwin-Lomax Factors for Turbulent Boundary Layers in Pressure Gradients", AIAA Journal, Vol. 25, No. 12, pp. 1624-1627.
Batchelor, G. K. (2000), An Introduction to Fluid Dynamics, ISBN 0521663962, 1st Edition, Ch. 5.7 Boundary Layers, pp.303.
  • External links: An author's homepage can be linked to from the author name. Publications that have homepages can be linked to from the title. Publications that are available for download (pdf or similar) should be linked to with a special download link at the end. Here is an example:

{{reference-paper|author=[http://www.h.jasak.dial.pipex.com/ Hrvoje, Jasak]|year=1996|title=Error
Analysis and Estimation for the Finite Volume Method with Applications to Fluid Flows|rest=PhD
Thesis, Imperial College, University of London 
([http://www.h.jasak.dsl.pipex.com/HrvojeJasakPhD.pdf download])}}

This reference would look like this:

Hrvoje, Jasak (1996), "Error Analysis and Estimation for the Finite Volume Method with Applications to Fluid Flows", PhD Thesis, Imperial College, University of London (download).
  • ISBN numbers: For publications that have ISBN numbers make sure to include these in the "rest" parameter using the format "ISBN 1234567890" (see book example above). If you do this the Wiki will automatically hot-link the ISBN to online book-stores.

Stubs

foo bar

Editing help

For some basic help on how to edit pages please visit WikiMedia Help for Editors or How to edit a page. For help with writing mathematical formulae, see the wikipedia help pages.

My wiki