Manual of Style: Difference between revisions

From Eterna Wiki

(Update with guidance on bolding)
(Add guidance for references and citations)
Line 8: Line 8:
<p>==Spelling==</p>
<p>==Spelling==</p>
<p>Generally speaking, American English spelling should be used. One exception is when quoting a piece of work that uses another spelling scheme - for example, British English - in which case it is acceptable to follow the spelling of the source material.</p>
<p>Generally speaking, American English spelling should be used. One exception is when quoting a piece of work that uses another spelling scheme - for example, British English - in which case it is acceptable to follow the spelling of the source material.</p>
<p>==References, Links, and Citations==</p>
<p>Whenever possible, links to and citations of scientific references should utilize a URL using a digital object identifier (DOI) rather than the "standard" URL obtained when just copying and pasting a website link. In theory, DOI links should be more robust and should lead to fewer "broken links" on the Wiki. Many scientific publishers include DOI information on each published article. Read more about DOI <a href="https://en.wikipedia.org/wiki/Digital_object_identifier">here</a>.</p>

Revision as of 19:05, 17 August 2021

This Manual of Style contains some style guidelines for the Eterna Wiki.

==Article Titles==

Pages should have titles fitting their content. Generally, words in a title should be capitalized using the "<a href="https://en.wikipedia.org/wiki/Title_case">title case</a>" set of rules. Additionally, the first usage of the article title within the article should be in bold (such as the bold "Manual of Style" in the first sentence of this article).

==Sections and Headings==

Articles containing an extensive amount of content should be split into sections with a heading describing each section. Similarly to article titles, headings should also use <a href="https://en.wikipedia.org/wiki/Title_case">title case</a> capitalization.

===Creating Headings===

Headings can be created when editing the Wiki by repeating the equal sign (=) symbol before and after the desired heading. To create the "Sections and Headings" heading for this section, 2 equal signs were put before and 2 were put after "Sections and Headings" - whereas to make the "Creating Headings" heading for this subsection, 3 equal signs were put before and 3 were put after.

==Spelling==

Generally speaking, American English spelling should be used. One exception is when quoting a piece of work that uses another spelling scheme - for example, British English - in which case it is acceptable to follow the spelling of the source material.

==References, Links, and Citations==

Whenever possible, links to and citations of scientific references should utilize a URL using a digital object identifier (DOI) rather than the "standard" URL obtained when just copying and pasting a website link. In theory, DOI links should be more robust and should lead to fewer "broken links" on the Wiki. Many scientific publishers include DOI information on each published article. Read more about DOI <a href="https://en.wikipedia.org/wiki/Digital_object_identifier">here</a>.