Site Tools

EXPLORE
By Tag By Geographic focus By Time Horizon By Topic By Publication Year By Document Type Index of Tags
By Section Library Encyclopedia Futures Hub Users
Social Newsletter About Us Slack Linkedin Twitter
EDITORS
Learn to Edit User Guide Policies Playground
Contribute Tasks Board Library Additions Contributor Slack
Tools Recent Changes Media Manager Sitemap
ACCOUNT
RegisterLog In


Follow on

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
hub:page_structure [2023/05/31 19:07] – ↷ Page moved from wiki:page_structure to hub:page_structure elizabethherfelhub:page_structure [2023/07/03 16:40] (current) – updated section on discussion posts to reflect discussion plugin elizabethherfel
Line 1: Line 1:
 ======Typical page structure====== ======Typical page structure======
-This page outlines typical sections that might exist on a wiki article and how they should be structured. Take this as a general guide, and not a firm rule. Different topics may need different sections to properly explain them. Editors are encouraged to use their own judgment when organizing articles. +This page outlines the typical sections that might exist on a page and how they should be structured. Take this as a general guide, and not a firm rule. Different topics may need different sections to properly explain them. Editors are encouraged to use their own judgment when organizing articles. 
 =====Articles vs. pages===== =====Articles vs. pages=====
-The term "page" encompasses all the material on Open Foresight Wiki, including encyclopedia topics, talk pages, tag pages, and special pages such as Recent changes . "Article" is a narrower term referring to a page containing a written composition on a specific topic. Thus, all articles are pages, but not all pages are articles.+The term "page" encompasses all the material on Open Foresight Hub, including encyclopedia topics, Editor Notes pages, tag pages, and special pages such as Recent changes . "Article" is a narrower term referring to a page containing a written composition on a specific topic. Thus, all articles are pages, but not all pages are articles.
  
 Some namespaces have built-in skeleton templates to help editors organize articles.  Some namespaces have built-in skeleton templates to help editors organize articles. 
Line 13: Line 13:
       *When the article title is the title of a published work “A Clockwork Orange” not “A clockwork orange”       *When the article title is the title of a published work “A Clockwork Orange” not “A clockwork orange”
   *Use a colon for subtitles: If your wiki article has a subtitle, use a colon to separate the main title from the subtitle (e.g., "How to write a wiki page: tips and best practices").   *Use a colon for subtitles: If your wiki article has a subtitle, use a colon to separate the main title from the subtitle (e.g., "How to write a wiki page: tips and best practices").
-=====Summary=====+=====Summary section=====
 Summarize the topic using neutral and objective language. In the summary, avoid using biased or subjective language that could be interpreted as promoting a particular point of view. Stick to the facts and present them in a neutral manner with citations. If the summary gets longer than a few (2-3) paragraphs, or you need to elaborate further, consider splitting it up into multiple subsections with second-fifth level headings. Summarize the topic using neutral and objective language. In the summary, avoid using biased or subjective language that could be interpreted as promoting a particular point of view. Stick to the facts and present them in a neutral manner with citations. If the summary gets longer than a few (2-3) paragraphs, or you need to elaborate further, consider splitting it up into multiple subsections with second-fifth level headings.
 =====Quick facts===== =====Quick facts=====
Line 22: Line 22:
 While you should aim for a neutral and objective tone in the summary sections, additional viewpoints is a place that allows editors to take a position on the topic, and provide commentary and criticism. This section should still be written in an expository style and claims should be supported by citations.  While you should aim for a neutral and objective tone in the summary sections, additional viewpoints is a place that allows editors to take a position on the topic, and provide commentary and criticism. This section should still be written in an expository style and claims should be supported by citations. 
 =====Discussion===== =====Discussion=====
-In discussion sections, you can discuss the topic in a more casual and conversational manner. +Many pages have Discussion sections, where registered users can comment on a page without directly editing it. In discussion sections, you can discuss the topic in a more casual and conversational manner. Editors may add discussion sections to pages by adding ''~~DISCUSSION~~'' into the page source. 
   *Write discussion posts in first person, and sign discussions with your username to make it easier for readers to follow the conversation.   *Write discussion posts in first person, and sign discussions with your username to make it easier for readers to follow the conversation.
-  *If discussion becomes long or unwieldy, editors may summarize or refactor discussion into the main body of the article, or spin off the discussion into a new page. +  *If discussion becomes very long or unwieldy, editors may summarize or refactor discussion into the main body of the article, or spin off the discussion into a new page. 
   *Keep your discussion relevant to the topic at hand, and make sure your post adds value to the conversation.    *Keep your discussion relevant to the topic at hand, and make sure your post adds value to the conversation. 
-  *Remember to be respectful of other editors.+  *Remember to be respectful of other editors. Comments that violate our [[code of conduct]] may be removed by administrators. 
 ====When to remove discussion comments==== ====When to remove discussion comments====
-Think of wiki articles as a public collaborative draft. The discussion section, like the main body of the article, can be edited to improve the quality of the page. Editors may remove discussion posts:+Administrators may remove discussion posts:
   *After incorporating points made in discussion comments into the main body of the article.   *After incorporating points made in discussion comments into the main body of the article.
-  *When issues raised in the discussion section have been resolved+  *Issues raised in the discussion section have been resolved
   *To make the page more readable   *To make the page more readable
   *If comments don’t add value. Example: “cool article!”   *If comments don’t add value. Example: “cool article!”
 +  *If the comment violates the [[code of conduct]] 
 ===When not to remove discussion comments=== ===When not to remove discussion comments===
-  *Don’t remove discussion posts because you disagree with their point+Administrators have the ability to temporarily hide or delete comments, but removing comments should not be taken lightly. Once deleted, discussion comments cannot be recovered. This is unlike edits made within the body of the page, which are easily recovered.  
 +  *Don’t remove discussion posts because you disagree with the commenter's point
   *Don’t remove discussion posts if the conversation is ongoing. Wait until the conversation has died down or reached consensus before removing it.   *Don’t remove discussion posts if the conversation is ongoing. Wait until the conversation has died down or reached consensus before removing it.
   *Don’t misrepresent what others have said. Be respectful of other posters when editing/removing discussion posts. It’s usually better to remove a post altogether than edit their statement.    *Don’t misrepresent what others have said. Be respectful of other posters when editing/removing discussion posts. It’s usually better to remove a post altogether than edit their statement. 
-====Discussion pages vs talk pages==== +====Discussion comments vs Editor Notes pages==== 
-Talk pages are to discuss administrative topics for a particular page, such as whether the page is in compliance with OFH policies and meets quality standards. The discussion section meanwhile is for discussing the article topic and content.  +Editor Notes pages are used to discuss administrative topics for a particular page, such as whether the page is in compliance with OFH policies and meets quality standards. The discussion section meanwhile is for discussing the article topic and content.  
-  *If you aren’t sure which to use, “//would this be helpful to someone looking for information about the article topic?//” is a good rule of thumb. If yes, use the discussion section. If no, use the talk page. +  *If you aren’t sure which to use, “//would this be helpful to someone looking for information about the article topic?//” is a good rule of thumb. If yes, use the discussion section. If no, use the editor notes. 
 =====Further Reading===== =====Further Reading=====
 The further reading section of an article contains a bulleted list of a reasonable number of works that a reader may consult for additional and more detailed coverage of the subject. This section may also contain a bulleted list of recommended relevant websites, each accompanied by a short description. These hyperlinks should not appear in the article's body text, nor should links used as references normally be duplicated in this section. The further reading section of an article contains a bulleted list of a reasonable number of works that a reader may consult for additional and more detailed coverage of the subject. This section may also contain a bulleted list of recommended relevant websites, each accompanied by a short description. These hyperlinks should not appear in the article's body text, nor should links used as references normally be duplicated in this section.
Last modified: 2023/05/31 19:07 by elizabethherfel