SklogWiki style guide

From SklogWiki
Revision as of 14:21, 12 February 2009 by Nice and Tidy (talk | contribs) (→‎DOI and References: Updated w.r.t. Cite extension.)
Jump to navigation Jump to search

Acronyms

Try to avoid the use of acronyms. You yourself may be over-familiar with a particular set of acronyms. However, SklogWiki is open to all, and acronyms can be confusing and/or off-putting. SklogWiki pages have no space restrictions, unlike published papers; so always try expand your acronym. At the very least, any acronym must be defined within the page it is used.

This should also apply to the names of the journals cited in the 'References' section.

Notation

Try try use, where possible, the International Union of Pure and Applied Chemistry approved nomenclature and symbols. For example, in the IUPAC Compendium of Chemical Terminology, popularly known as the Gold Book, the Helmholtz free energy is now known as the Helmholtz energy (function) ().

Equations

The equations are formed using LaTeX math markup. Indent equations by placing a colon before the equation.

DOI and References

Link to published papers by using (when possible) its Digital Object Identifier. The Digital Object Identifier of an on-line paper can almost always be found somewhere in the on-line abstract of an article. By placing this code after http://dx.doi.org/ one is led directly to the on-line version of the paper.

Using the Cite extension:

<ref>[http://dx.doi.org/---DOI--- Author "Title", Journal '''volume''' pp. firstPage-lastPage (year)]</ref>

There is no particular preference in SklogWiki regarding the use of the serial comma in the author list.

Professional

SklogWiki is a 'professional' Wiki; comments of a personal nature are not permitted.

Using material from American Physical Society (APS) Journals

The following statement is quoted from the APS website:

Sites like wikipedia and quantiki are strict about permissions and require that authors hold copyright to articles that they post there. In order to allow authors to comply with this requirement, APS permits authors to hold copyright to a "derived work" based on an article published in an APS journal as long as the work contains at least 10% new material not covered by APS's copyright and does not contain more than 50% of the text (including equations) of the original article.

Using material from Wikipedia

See the page http://en.wikipedia.org/wiki/Wikipedia:Copyrights for details. The following section is adapted from the aforementioned page:

"The license Wikipedia uses grants free access to our content in the same sense as free software is licensed freely. This principle is known as copyleft. That is to say, Wikipedia content can be copied, modified, and redistributed so long as the new version grants the same freedoms to others and acknowledges the authors of the Wikipedia article used (a direct link back to the article satisfies our author credit requirement). Wikipedia articles therefore will remain free forever and can be used by anybody subject to certain restrictions, most of which serve to ensure that freedom."

Notability

One of the important differences between SklogWiki and Wikipedia is that SklogWiki has no notability criteria. Indeed, this was one of the incentives for the creation of SklogWiki. SklogWiki accepts original work, commentaries, or pages that are dedicated to a single or series of papers published in a 'traditional' journal. Material that falls within the scope of SklogWiki is sufficient raison d'être for its inclusion.

Protection

Any essays in the submitted to the short essays section, as well as any pages containing copyrighted material, will be protected to disallow further editing once the material has been uploaded.