How to use and contribute: Difference between revisions

From Atomix
m Organising the help pages...
 
(28 intermediate revisions by the same user not shown)
Line 1: Line 1:
= Creating and editing wiki pages =
We collated [[Editing tips|editing tips]] for the wiki collected from other sources and individual's experiences using the wiki. The information below provides some brief guidelines on creating and commenting ATOMIX's wiki pages.
* You can [[Create and edit wiki|create new pages and edit]] existing ones provided you have a user account.  At the moment, only ATOMIX working group members have access as we begin organizing the information.


* [[:Category:Concept]] and [[:Category:Fundamentals]] pages can created using the same template/forms.
== Creating and editing wiki pages ==
Existing ATOMIX group members may [[Create and edit wiki|create and edit]] existing wiki pages provided they have a user account.


* Please follow the same [https://en.m.wikipedia.org/wiki/Wikipedia:Article_titles guidelines] as Wikipedia when providing titles for any wiki pages.
=== Naming of new pages ===
** Don’t start titles with articles and prepositions  
Please follow the same [https://en.m.wikipedia.org/wiki/Wikipedia:Article_titles guidelines] as Wikipedia when providing titles for any wiki pages.
** No acronyms unless they are very well known
* Avoid starting titles with articles and prepositions (e.g., avoid "The" and "A")
** And many more
* No acronyms unless they well known (e.g., ADCP)
* First letter is capitalised
* Title should reflect the content of the page, and not be chosen to match nicely with the text that links to it.


= Peer-review and commenting =
=== Linking (piping) pages ===
You can link to internal wiki pages via alternate text. For example writing <nowiki>[[Turbulence spectrum| turbulence page]]</nowiki>  will link the words [[Turbulence spectrum| turbulence page]] to an internal page called Turbulence spectrum.


* Please take a look at [[Talk:Main_Page |discussion page]] for help on threaded comments.
=== Format of new page ===
* Eventually, we'll be accepting comments from the community when the processing steps will be delineated on the wiki. We're in the process of establishing the how and where, but "when" is in 2022.
All pages should start with an introduction or lead of some sort, unless you're using the concept/fundamental form.


= Tips and tricks =


<div class="mw-collapsible" data-collapsetext="Collapse" data-expandtext="Expand Tips and Tricks">
==Watching pages==
Beyond using the editor, there are a few tips for adding internal links, which are described on [https://www.mediawiki.org/wiki/Help:Links#Internal_links MediaWiki help].  
Each user has under their account profile their list of [[Special:Watchlist|watched pages]]. By default, all pages that you edit are "watched", but you can edit which ones and control how (if) you are notified about edits of these pages as they occur.


* The most important trick is the piped internal links. For example writing <nowiki>[[Turbulence spectrum| turbulence page]]</nowiki> which link the words [[Turbulence spectrum| turbulence page]] to an internal page called Turbulence spectrum.
== Peer-review and commenting ==
 
* Each page has a discussion page associated with it that allows users to discuss content about the page.
* [https://www.mediawiki.org/wiki/Help:Lists Help with creating lists]
** These discussion pages are '''not''' for tracking or versioning your edits. There's a "history" toggle you can use for this purpose.  
 
* Please take a look at [[Talk:How_to_use_and_contribute|discussion page]] for help on threaded comments to use on discussion pages.
==Inserting special symbols and math==
** Using 4 tildes <nowiki>~~~~</nowiki> will sign your username and date automatically
Wrap your Tex code with <nowiki><math>\varepsilon</math></nowiki> to render <math>\varepsilon</math>
* Eventually, we'll be accepting comments from the community when the processing steps will be delineated on the wiki. We're in the process of establishing the how and where, but it will be in the second half of 2022.
* The [[:Form:ReviewStage|Review stage form]] and [[:Template:ReviewStage|template]] are being trialed to facilitate internal peer-reviewing.


==Citing and references==
==Citing and references==
Line 33: Line 36:
* The <nowiki><references/></nowiki> tag inserts the text of all the citations which have defined using  <nowiki><ref></ref></nowiki>tags up to that point in the page.
* The <nowiki><references/></nowiki> tag inserts the text of all the citations which have defined using  <nowiki><ref></ref></nowiki>tags up to that point in the page.


==Creating tables==
==Categorizing information==
Tables can be converted from a spreadsheet (or latex code) into a MediaWiki by copy and pasting it into this handy  [https://tablesgenerator.com online tool] using their file menu. You can also paste Mediawiki, markdown or HTML code into the tool. You can then manipulate the table's or cell's format and generate code in different languages (csv, standard excel tables, MediaWiki and TeX tables, and more).
There are a few categories for organising pages. Whenever possible, please include the subgroup categories:
* [[:Category:Shear_probes]]
* [[:Category:Velocity_point-measurements]]
* [[:Category:Velocity_profilers‏‎]]  
at the bottom of the page when not using "edit with forms" such as those associated with
* [[:Category:Concept]] and [[:Category:Fundamentals]] pages.


==Examples of collapsible items ==
To add a category use <nowiki>[[Category|Name_of_category]]</nowiki>.  
Below are examples of formatting used in this page for future reference.


=== Test 1: Collapsible table with caption===
This page uses the <nowiki>[[Category|Help]]</nowiki>
{| class="wikitable sortable mw-collapsible"
|+ I am a caption! Table is sortable too.
! Hello
! World
|-
| Content
| Goes
|-
| In
| Here
|}


=== Test 2: Collapsible lists ===
Level 1 data ....
<ul class="mw-collapsible" data-collapsetext="You may collapse me by clicking here" data-expandtext="Let me back out !">
  <li>Lorem</li>
  <li>Ipsum</li>
  <li>Dolor</li>
</ul>




=Notes=




[[Category:Help]]
[[Category:Help]]

Latest revision as of 00:48, 17 December 2021

We collated editing tips for the wiki collected from other sources and individual's experiences using the wiki. The information below provides some brief guidelines on creating and commenting ATOMIX's wiki pages.

Creating and editing wiki pages

Existing ATOMIX group members may create and edit existing wiki pages provided they have a user account.

Naming of new pages

Please follow the same guidelines as Wikipedia when providing titles for any wiki pages.

  • Avoid starting titles with articles and prepositions (e.g., avoid "The" and "A")
  • No acronyms unless they well known (e.g., ADCP)
  • First letter is capitalised
  • Title should reflect the content of the page, and not be chosen to match nicely with the text that links to it.

Linking (piping) pages

You can link to internal wiki pages via alternate text. For example writing [[Turbulence spectrum| turbulence page]] will link the words turbulence page to an internal page called Turbulence spectrum.

Format of new page

All pages should start with an introduction or lead of some sort, unless you're using the concept/fundamental form.


Watching pages

Each user has under their account profile their list of watched pages. By default, all pages that you edit are "watched", but you can edit which ones and control how (if) you are notified about edits of these pages as they occur.

Peer-review and commenting

  • Each page has a discussion page associated with it that allows users to discuss content about the page.
    • These discussion pages are not for tracking or versioning your edits. There's a "history" toggle you can use for this purpose.
  • Please take a look at discussion page for help on threaded comments to use on discussion pages.
    • Using 4 tildes ~~~~ will sign your username and date automatically
  • Eventually, we'll be accepting comments from the community when the processing steps will be delineated on the wiki. We're in the process of establishing the how and where, but it will be in the second half of 2022.
  • The Review stage form and template are being trialed to facilitate internal peer-reviewing.

Citing and references

  • To streamline formatting of published papers, please follow the instructions from the Cite journal template within the <ref></ref> tags.
  • By default, the formatted references will appear at the bottom of the page. It's good practice to place a section ==Notes== at the bottom of the page.
  • The <references/> tag inserts the text of all the citations which have defined using <ref></ref>tags up to that point in the page.

Categorizing information

There are a few categories for organising pages. Whenever possible, please include the subgroup categories:

at the bottom of the page when not using "edit with forms" such as those associated with

To add a category use [[Category|Name_of_category]]. 

This page uses the [[Category|Help]]