Difference between revisions of "Discussion Page Tutorial"

From Linked Earth Wiki
Jump to: navigation, search
(Add information about signature)
(Add link to the YouTube video)
 
(6 intermediate revisions by the same user not shown)
Line 1: Line 1:
The LinkedEarth wiki supports '''talk pages''' (also know as '''discussion pages'''). A discussion page is a page which editors can use to discuss improvements to the LinkedEarth ontology or to an article on the wiki. When viewing a page on the LinkedEarth wiki, a link to the corresponding discussion page appears on the "Discussion" tab at the tops of the page. Click this tab to switch to the discussion page.  
+
The LinkedEarth wiki supports '''talk pages''' (also know as '''discussion pages'''). A discussion page is a page which members of the LinkedEarth community can use to discuss improvements to the LinkedEarth ontology or to an article on the wiki. When viewing a page on the LinkedEarth wiki, a link to the corresponding discussion page appears on the "Discussion" tab at the top of the page (Figure 1). Click this tab to switch to the discussion page.  
  
[[File:DiscussionPage_ScreenShot_Tutorial.png|thumb|right|Location of the discussion tab.]]
+
[[File:DiscussionPage_ScreenShot_Tutorial.png|thumb|right|Figure 1: Location of the discussion tab.]]
  
 
User pages also have associated discussion pages (for example, [[User_talk:Khider]]). When the LinkedEarth team and other editors need to contact you, they can leave you a message on your talk page.
 
User pages also have associated discussion pages (for example, [[User_talk:Khider]]). When the LinkedEarth team and other editors need to contact you, they can leave you a message on your talk page.
 +
 +
A YouTube version of this tutorial is available [https://www.youtube.com/watch?v=qSx1DCdyiJ4 here].
  
 
== Where to find discussion pages==
 
== Where to find discussion pages==
Line 11: Line 13:
 
If the "discussion" link is in red, it means that the discussion page has not been started yet. Click on the red link to create the page.  
 
If the "discussion" link is in red, it means that the discussion page has not been started yet. Click on the red link to create the page.  
  
== Discussion page use==
+
== Starting a Discussion ==
 +
 
 +
The LinkedEarth wiki uses the [https://www.mediawiki.org/wiki/Extension:DiscussionThreading Discussion Threading Extension]. Below is a quick overseen on how to use this extension, using this page's [[{{TALKPAGENAME}}|Discussion]] as an example. If you want to test how this all works, feel free to use the [[{{TALKPAGENAME}}|Discussion]] as a sandbox.
 +
 
 +
*To create (or edit) the page, click on the "Discussion" tab at the top of the page. If the page has not yet been created, you'll be prompted to start the discussion (Figure 2).
 +
 
 +
[[File:CreatingDiscussionPage.png|thumb|none|500px|Figure 2: Creating a new discussion page]]
 +
 
 +
*Enter the subject of the first thread (i.e. topic) in the subject/headline box (Figure 3).
 +
 
 +
[[File:StartDiscussionThread Annotated.png|thumb|none|500px|Figure 3: Enter the subject of the discussion]]
 +
 
 +
* And start the discussion (Figure 4)
 +
 
 +
[[File:StartDiscussionThread Annotated2.png|thumb|none|500px|Figure 4: Enter the discussion]]
 +
 
 +
* Click "save" at the bottom of the page to commit your changes (Figure 5).
 +
 
 +
[[File:SavePage Annotated.png|thumb|none|500px|Figure 5: Enter the discussion]]
 +
 
 +
* Your changes will be saved and appear on the Discussion page (Figure 6).
 +
 
 +
[[File:DiscussionPageAfterSave.png|thumb|none|500px|Figure 6: A Discussion page with content]]
 +
 
 +
The wiki automatically tracks the user name and the date/time at which the thread was started.
 +
 
 +
== Replying to a thread ==
 +
 
 +
Anyone with the LinkedEarth account can reply on a thread on a Discussion page regardless of user privileges.
 +
 
 +
* Click on "reply" to the right of the title of the particular thread you wish to reply to (Figure 7)
 +
 
 +
[[File:ReplyButton Annotated.png|thumb|none|500px|Figure 7: Location of the reply link]]
 +
 
 +
* You'll be able to enter your reply under "Re: Title of the discussion thread" (Figure 8)
 +
 
 +
[[File:ReplaceThisTextWithyourReply highlighted.png|thumb|none|500px|Figure 8: Where to enter a reply]]
 +
 
 +
* Save your reply and it will automatically appear with your name and date/time of the reply (Figure 9).
 +
 
 +
[[File:AfterAReplyHasBeenPosted.png|thumb|none|500px|Figure 9: Discussion thread with a reply]]
 +
 
 +
== Starting a new thread ==
 +
 
 +
If you'd like to start a new topic of discussion on the same term in the ontology (wiki page), you should start a new thread. For instance, one thread could deal with the definition of the term itself while another could deal with whether it should be considered essential metadata for a particular archive.
 +
 
 +
* To start a new thread, click on "Add Topic" (Figure 10)
  
This guide aims to identify '''good layout practices''' and makes '''general recommendations''' for the ordering of content. This guide cannot cover every possibility likely to be encountered over the course of the project, so please always use [https://en.wikipedia.org/wiki/Wikipedia:Ignore_all_rules common sense] and good editorial judgement.
+
[[File:AddTopic Annotated.png|thumb|none|500px|Figure 10: Location of the "Add Topic" tab]]
  
===Layout===
+
* Start a new tread with the new topic of discussion and click "save page"
  
The LinkedEarth wiki uses the [https://en.wikipedia.org/wiki/Wikipedia:Talk_page_layout Wikipedia layout] for discussion pages.  
+
The wiki now shows the two threads (Figure 11). You can reply to either of these threads.  
  
=== Sign your contribution===
+
[[File:DiscussionWithTwoThreads.png|thumb|none|500px|Figure 11: Location of the "Add Topic" tab]]
  
You should [https://en.wikipedia.org/wiki/Wikipedia:Signatures sign and date] all your contributions on the discussion page. To do this easily, type four tildes (<nowiki>~~~~</nowiki>) at the end of your comment. This will be automatically converted into a user signature and the data and time. (You can change the form of your signature using your [[Special:Preferences | user preferences]]).
+
== Using a poll ==
  
Unsigned comments will be periodically removed by the Editorial Board.
+
Like any other page on the wiki, you can create a poll in the discussion page to gather community input on a particular topic (Figure 12). To learn how to create a poll on the LinkedEarth wiki, see our [[Quick Guide to Editing Wiki Pages]].
  
===Indentation===
+
[[File:DiscussionPageWithAPoll.png|thumb|none|500px|Figure 12: Discussion Page with a Poll]]

Latest revision as of 18:25, 27 September 2016

The LinkedEarth wiki supports talk pages (also know as discussion pages). A discussion page is a page which members of the LinkedEarth community can use to discuss improvements to the LinkedEarth ontology or to an article on the wiki. When viewing a page on the LinkedEarth wiki, a link to the corresponding discussion page appears on the "Discussion" tab at the top of the page (Figure 1). Click this tab to switch to the discussion page.

Figure 1: Location of the discussion tab.

User pages also have associated discussion pages (for example, User_talk:Khider). When the LinkedEarth team and other editors need to contact you, they can leave you a message on your talk page.

A YouTube version of this tutorial is available here.

Where to find discussion pages

When viewing any pages on the LinkedEarth Wiki, a link to the corresponding discussion page appears on the "Discussion" tab at the top of the page. Click this tab to switch to the discussion page; you can view the discussion page, edit it, to view its history like any other LinkedEarth wiki page.

If the "discussion" link is in red, it means that the discussion page has not been started yet. Click on the red link to create the page.

Starting a Discussion

The LinkedEarth wiki uses the Discussion Threading Extension. Below is a quick overseen on how to use this extension, using this page's Discussion as an example. If you want to test how this all works, feel free to use the Discussion as a sandbox.

  • To create (or edit) the page, click on the "Discussion" tab at the top of the page. If the page has not yet been created, you'll be prompted to start the discussion (Figure 2).
Figure 2: Creating a new discussion page
  • Enter the subject of the first thread (i.e. topic) in the subject/headline box (Figure 3).
Figure 3: Enter the subject of the discussion
  • And start the discussion (Figure 4)
Figure 4: Enter the discussion
  • Click "save" at the bottom of the page to commit your changes (Figure 5).
Figure 5: Enter the discussion
  • Your changes will be saved and appear on the Discussion page (Figure 6).
Figure 6: A Discussion page with content

The wiki automatically tracks the user name and the date/time at which the thread was started.

Replying to a thread

Anyone with the LinkedEarth account can reply on a thread on a Discussion page regardless of user privileges.

  • Click on "reply" to the right of the title of the particular thread you wish to reply to (Figure 7)
Figure 7: Location of the reply link
  • You'll be able to enter your reply under "Re: Title of the discussion thread" (Figure 8)
Figure 8: Where to enter a reply
  • Save your reply and it will automatically appear with your name and date/time of the reply (Figure 9).
Figure 9: Discussion thread with a reply

Starting a new thread

If you'd like to start a new topic of discussion on the same term in the ontology (wiki page), you should start a new thread. For instance, one thread could deal with the definition of the term itself while another could deal with whether it should be considered essential metadata for a particular archive.

  • To start a new thread, click on "Add Topic" (Figure 10)
Figure 10: Location of the "Add Topic" tab
  • Start a new tread with the new topic of discussion and click "save page"

The wiki now shows the two threads (Figure 11). You can reply to either of these threads.

Figure 11: Location of the "Add Topic" tab

Using a poll

Like any other page on the wiki, you can create a poll in the discussion page to gather community input on a particular topic (Figure 12). To learn how to create a poll on the LinkedEarth wiki, see our Quick Guide to Editing Wiki Pages.

Figure 12: Discussion Page with a Poll