Difference between revisions of "Discussion Page Tutorial"

From Linked Earth Wiki
Jump to: navigation, search
m (Fix link)
(Add link to the YouTube video)
 
(7 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==
 +
 +
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 [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)
 +
 +
[[File:AddTopic Annotated.png|thumb|none|500px|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.
 +
 +
[[File:DiscussionWithTwoThreads.png|thumb|none|500px|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]].
 +
 +
[[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