Discussion Page Tutorial - Revision history

Khider: Add link to the YouTube video

2016-09-27T18:25:24Z

Add link to the YouTube video

Khider: fix typo

2016-09-25T23:44:43Z

fix typo

Khider: Include a poll in the discussion page

2016-09-23T22:15:50Z

Include a poll in the discussion page

Khider: Adding a thread tutorial

2016-09-23T21:57:19Z

Adding a thread tutorial

Khider: Section on replying to a thread

2016-09-23T21:32:32Z

Section on replying to a thread

Khider: Remove the section on use (redundant from the introduction)

2016-09-23T21:19:22Z

Remove the section on use (redundant from the introduction)

Khider: Tutorial on how to start a discussion

2016-09-23T21:17:14Z

Tutorial on how to start a discussion

Khider: Add information about signature

2016-08-08T23:09:44Z

Add information about signature

Khider: Fix link

2016-08-08T22:57:29Z

Fix link

Khider: Edit figure caption

2016-08-08T22:56:54Z

Edit figure caption

← Older revision		Revision as of 18:25, 27 September 2016
Line 4:		Line 4:

	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==

← Older revision		Revision as of 23:44, 25 September 2016
Line 1:		Line 1:
−	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 ~~tops~~ of the page (Figure 1). 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\|Figure 1: Location of the discussion tab.]]		[[File:DiscussionPage_ScreenShot_Tutorial.png\|thumb\|right\|Figure 1: Location of the discussion tab.]]

← Older revision		Revision as of 22:15, 23 September 2016
Line 66:		Line 66:

	[[File:DiscussionWithTwoThreads.png\|thumb\|none\|500px\|Figure 11: Location of the "Add Topic" tab]]		[[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]]

← Older revision		Revision as of 21:57, 23 September 2016
Line 52:		Line 52:

	[[File:AfterAReplyHasBeenPosted.png\|thumb\|none\|500px\|Figure 9: Discussion thread with a reply]]		[[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]]

← Older revision		Revision as of 21:32, 23 September 2016
Line 34:		Line 34:

	[[File:DiscussionPageAfterSave.png\|thumb\|none\|500px\|Figure 6: A Discussion page with content]]		[[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]]

← Older revision		Revision as of 21:19, 23 September 2016
Line 10:		Line 10:

	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==~~
−
−	The Discussion page should be used to discuss a term in the LinkedEarth ontology or an article on the wiki. For instance, you may suggesting renaming a term in the ontology or updating a crowd term to the core. If you want to stimulate discussion, you can link to the Discussion page directly from any other page on the wiki (see the [[Quick Guide to Editing Wiki Pages]] to learn how to link).

	== Starting a Discussion ==		== Starting a Discussion ==

@@ 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 tops 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.
@@ Line 13: / Line 13: @@
 == Discussion page use==
-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.
+The Discussion page should be used to discuss a term in the LinkedEarth ontology or an article on the wiki. For instance, you may suggesting renaming a term in the ontology or updating a crowd term to the core. If you want to stimulate discussion, you can link to the Discussion page directly from any other page on the wiki (see the [[Quick Guide to Editing Wiki Pages]] to learn how to link).
-===Layout===
+== Starting a Discussion ==
-The LinkedEarth wiki uses the [https://en.wikipedia.org/wiki/Wikipedia:Talk_page_layout Wikipedia layout] for discussion pages.
+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.
-=== Sign your contribution===
+*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).
-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]]).
+[[File:CreatingDiscussionPage.png|thumb|none|500px|Figure 2: Creating a new discussion page]]
-Unsigned comments will be periodically removed by the Editorial Board.
+*Enter the subject of the first thread (i.e. topic) in the subject/headline box (Figure 3).
-===Indentation===
+[[File:StartDiscussionThread Annotated.png|thumb|none|500px|Figure 3: Enter the subject of the discussion]]

← Older revision		Revision as of 23:09, 8 August 2016
Line 4:		Line 4:

	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.
		+
		+	== 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.
		+
		+	== Discussion page use==
		+
		+	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.
		+
		+	===Layout===
		+
		+	The LinkedEarth wiki uses the [https://en.wikipedia.org/wiki/Wikipedia:Talk_page_layout Wikipedia layout] for discussion pages.
		+
		+	=== Sign your contribution===
		+
		+	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]]).
		+
		+	Unsigned comments will be periodically removed by the Editorial Board.
		+
		+	===Indentation===

← Older revision		Revision as of 22:57, 8 August 2016
Line 3:		Line 3:
	[[File:DiscussionPage_ScreenShot_Tutorial.png\|thumb\|right\|Location of the discussion tab.]]		[[File:DiscussionPage_ScreenShot_Tutorial.png\|thumb\|right\|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.