Help:Contents: Difference between revisions

Latest revision as of 16:10, 15 June 2019

For a short version with formatting recommendations, see our entry on the Rules of the P2P Foundation Wiki

Please note that this wiki insists on sourcing, when it comes from an existing external source, or signing if it is a personal contribution.

Welcome!

Welcome to the P2P Foundation's wiki!

Here on the P2P Foundation Wiki we are working on original approaches to complex problems. You will find peers from all over the world collaborating here on the wiki. We use the wiki to write original works, and to collect references to important trends and solutions.

Here you will find some basic instructions to help orient you on how we would like the wiki to evolve. Taking the time to get acquainted with these guidelines and on how to use MediaWiki tools in general will make your work easier, so please do explore the wiki before jumping in with both feet!

Style guidance

Doing things in a similar way to everyone else here really helps: it helps people learn how this wiki works; it helps readers to know what to expect and to be able to find the information that they are interested in.

But it isn't exactly the same as Wikipedia, so please note the local conventions.

Please read Help:Differences Between This Wiki and Wikipedia if you have experience of editing Wikipedia or another wiki with similar standards.

Your development as a contributor

Please register and create an account: Once you confirm your email address you may edit pages on the wiki.

Create your user page and/or bio page: This is useful experience as well as being helpful to others.

Start using your UserPage or the Sandbox for practice.: Gain familiarity with making links and new pages. Your user page is linked from your username in the top right of any page.

Understand how to use categories on this wiki.: Putting in good category tags may help readers. Having lots of small categories is very unlikely to help.

Become familiar with references along with the P2P Foundation's copyright policy.

Gain more skills at editing: If you aren't sure how to format something, visit the Editing Help page for more information.

Deeper technical questions?: If you want to know everything about editing and Mediawiki (the software for this site) try the Mediawiki Help Contents.

Checking Your Work

Do make a habit of finding related articles: See additional help with searching for duplicates and related articles.

Do visit find answers to your editing questions: See the Help:Editing page for information about additional conventions for your articles.

Do proofread your articles: Do what you can to write with good spelling and grammar.

Do follow the site's article naming convention: Page names should be full titles, so instead of "IntroToBlogs" use "Introduction to Blogs". They should also follow the Dr. Grammar rules regarding capitalization thus:; "In titles, capitalize the first word, the last word, and all words in between except articles (a, an, and the), prepositions under five letters (in, of, to), and coordinating conjunctions (and, but). These rules apply to titles of long, short, and partial works as well as your own papers" (Anson, Schwegler, and Muth. The Longman Writer's Companion 240)

Do discuss articles!: Do you see something that is perhaps incorrect, or needs clarification? The best way to make mention of any issues is to use the DISCUSSION function. Please refrain from adding your comments directly onto the ARTICLE page. Every page has a DISCUSSION tab on it. This is the place to make your comments, suggestions, and to engage authors in discourse.; Please do create a horizontal rule between comments on the discussion page by using four dashes ---- between entries.; Please do add four ~s to add your "signature" with a time-stamp -- useful for discussion pages OR just click on the signature icon at the top of the edit window...it's the second one from the right.

Do have fun. :)

Things to Look Out For

Do avoid creating empty pages: Please do NOT create blank pages simply as placeholders. Once the pages are created, they are live, and any links to them will then work. When a user clicks their way to an empty page, they have just wasted some of their time. PLEASE - only create pages when you have some content to put into them. You need not have a complete page, but there should be something of value there for users. Thank you!

Do avoid sub-pages: Our standard is to NOT create any sub-pages, EXCEPT for personal pages of Wiki Users and for the Template Tags. These are pages with a "/" in the title. If there is a "User:GoodRollin" page, then a sub-page is "User:GoodRollin/My Sub Page". You can use these pages for your sandbox when you create subpages from your User but they are not appropriate for the rest of the site at this time. Thank you!

Do avoid CamelCase for page titles: : For example, if you want to create a page named "About Emakina", you can type http://research.emakina.net/About_Emakina into your address bar, and the new page will automatically be created. When you wish to link to a created page, create the link with the Wiki format of: [[About Emakina]] and not the CamelCase [[AboutUs]]. Thank you!

Duplicate pages...

What Not To Do

Wikis are really great for working collaboratively with a large group of people. Many wikis, like Wikipedia have millions of editors. This is not Wikipedia. We have only a few administrators, perhaps a hundred editors, and a lot of visitors looking for what would often be considered very specific information. Because of this it is very important that we are clear that spamming is not tolerated, and that your account will be blocked if you are caught in the act of any of the following activities.

Do not post malicious code: It's not nice; you and your IP will be blocked.

Do not link to commercial products: Commercial links have no place on this wiki. You will be warned and your articles will be deleted. A second offense and you and your IP will be blocked.

Following Up

If you have any questions that you can't find the answers to you can visit the discussion tab above and leave a note. Be sure to sign your note with four dashes '~' which will put your name in and a link to your User page. You can also use the button that has a squiggle of cursive writing on it to sign your note.

@@ Line 1: / Line 1: @@
-;Welcome! : Here you will find some basic instructions to help orient you on how we would like the new Wiki to evolve. Taking the time to get acquainted with these guidelines and on how to use MediaWiki tools in general will make your work easier, so please do explore the Wiki before jumping in with both feet!
+__NOTOC__
+For a short version with formatting recommendations, see our entry on the [[Rules of the P2P Foundation Wiki]]
-{| cellspacing=3 width="100%"
+Please note that this wiki insists on sourcing, when it comes from an existing external source, or signing if it is a personal contribution.
-|colspan="2" style="border: 1px dashed black;padding-left:1em;padding-right:0.5em; background: #eee;"|
-= Minimum Standards =
+==Welcome!==
+Welcome to the P2P Foundation's wiki!
+Here on the P2P Foundation Wiki we are working on original approaches to complex problems.  You will find peers from all over the world collaborating here on the wiki.  We use the wiki to write original works, and to collect references to important  trends and solutions.
+Here you will find some basic instructions to help orient you on how we would like the wiki to evolve. Taking the time to get acquainted with these guidelines and on how to use MediaWiki tools in general will make your work easier, so please do explore the wiki before jumping in with both feet!
+==Style guidance==
+Doing things in a similar way to everyone else here really helps:
+it helps people learn how this wiki works;
+it helps readers to know what to expect and to be able to find the information that they are interested in.
+But it isn't exactly the same as Wikipedia, so please note the local conventions.
-We've already had a few flubs, so to make sure we're all on the same page, we've come up with the following standards:
+'''Please read [[Help:Differences Between This Wiki and Wikipedia]]'''
+if you have experience of editing Wikipedia or another wiki with similar standards.
-;''Please register and create and account'' : It is mandatory at this time, please contact Michel Bauwens. Thanks!
+==Your development as a contributor==
-;Use the [[Sandbox | Sandbox]] page for practice : The [[Sandbox | Sandbox]] is a great place to get your feet wet without worrying about goofing something up.
+; [[Special:UserLogin | Please register and create an account]] : Once you confirm your email address you may edit pages on the wiki.
-;Help with Wiki formatting : If you aren't sure how to format something, visit the [[Help:Editing Editing Help page]] for more information.
+; Create [[Help:Your User Page and Bio | your user page and/or bio page]] : This is useful experience as well as being helpful to others.
-;MediaWiki manual : If you want to learn more about using this new repository see the excellent [http://meta.wikipedia.org/wiki/MediaWiki_User%27s_Guide MediaWiki User's Guide].
+; Start using your UserPage or the [[Sandbox]] for practice.
-----
+: Gain familiarity with [[Help:How to Make Links and New Pages | making links and new pages]].  Your user page is linked from your username in the top right of any page.
-;Do not use CamelCase for page titles: : For example, if you want to create a page named "About Emakina", you can type <code><nowiki>http://research.emakina.net/About_Emakina</nowiki></code> into your address bar, and the new page will automatically be created. When you wish to link to a created page, create the link with the Wiki format of: <code><nowiki>[[About Emakina]]</nowiki></code> and not the CamelCase <code><nowiki>[[AboutUs]]</nowiki></code>.
+; Understand [[Help:Using Categories | how to use categories on this wiki]].
+: Putting in good category tags may help readers. Having lots of small categories is very unlikely to help.
-;Sub pages : Our standard is to '''NOT''' create any sub pages, EXCEPT for personal pages of Wiki Users and for the Template Tags.
+; Become familiar with [[Help:References | references]] along with the [[P2P Foundation:Copyright | P2P Foundation's copyright policy]].
-;Search the Wiki before creating new pages : Make sure a page doesn't already exist.
+; Gain more skills at editing : If you aren't sure how to format something, visit the [[Help:Editing | Editing Help page]] for more information.
-;Proofread : Ensure your work has proper spelling and grammar.
+; Deeper technical questions? : If you want to know everything about editing and [http://mediawiki.org Mediawiki] (the software for this site) try the [https://www.mediawiki.org/wiki/Help:Contents Mediawiki Help Contents].
-;Empty pages : Please do NOT create blank pages simply as placeholders. Once the pages are created, they are live, and any links to them will then work. When a user clicks their way to an empty page, they have just wasted some of their time. PLEASE - only create pages when you have some content to put into them. You need not have a complete page, but there should be something of value there for users. '''''Thank you!'''''
+==Checking Your Work==
+;Do make a habit of finding related articles : See additional help with [[Help:Search for Duplicates and Related Articles | searching for duplicates and related articles]].
-;Incomplete pages : If you think a page is incomplete, mark the page as such by using the Stub template. You do this by inserting the following tag: <code><nowiki>{{Stub}}</nowiki></code>. '''(NOTE: The Stub tag is case-sensitive!)'''
+;Do visit find answers to your editing questions : See the [[Help:Editing | Help:Editing page]] for information about additional conventions for your articles.
-;Duplicate pages : If you think that Page A is a copy of Page B, or even close, then please use <nowiki>{{merge}}</nowiki> to tag the pages as requiring merging.
+;Do proofread your articles : Do what you can to write with good spelling and grammar.
-;Pages to be deleted : If you find a page that should not, or need not be there, or is inappropriate, edit the page to have the <nowiki>{{rfd}}</nowiki> tag. This will alert Brice to look into it for deletion.
+;Do follow the site's article naming convention : Page names should be full titles, so instead of "IntroToBlogs" use "Introduction to Blogs". They should also follow the Dr. Grammar rules regarding capitalization thus:
+:'''"In titles, capitalize the first word, the last word, and all words in between except articles (a, an, and the), prepositions under five letters (in, of, to), and coordinating conjunctions (and, but). These rules apply to titles of long, short, and partial works as well as your own papers"''' ''(Anson, Schwegler, and Muth. The Longman Writer's Companion 240)''
-;Page names : These should be full titles, so instead of "IntroToBlogs" have "Introduction to Blogs". They should also follow the Dr. Grammar rules regarding capitalization thus:
+;Do discuss articles! : Do you see something that is perhaps incorrect, or needs clarification? The best way to make mention of any issues is to use the DISCUSSION function. Please refrain from adding your comments directly onto the ARTICLE page. Every page has a '''''DISCUSSION tab''''' on it.  This is the place to make your comments, suggestions, and to engage authors in discourse.
+: Please do create a horizontal rule between comments on the discussion page by using four dashes <nowiki>----</nowiki> between entries.
+: Please do add four ~s to add your "signature" with a time-stamp -- useful for discussion pages OR just click on the signature icon at the top of the edit window...it's the second one from the right.
-'''"In titles, capitalize the first word, the last word, and all words in between except articles (a, an, and the), prepositions under five letters (in, of, to), and coordinating conjunctions (and, but). These rules apply to titles of long, short, and partial works as well as your own papers"''' ''(Anson, Schwegler, and Muth. The Longman Writer's Companion 240)''
+;''' Do have fun. :)'''
-;Discussion : Do you see something that is perhaps incorrect, or needs clarification? The best way to make mention of any issues is to use the DISCUSSION function. Please refrain from adding your comments directly onto the ARTICLE page. If you notice at the top, every page has a '''''DISCUSSION tab''''' on it, which is the place to make your comments, suggestions, and such. Thank you!
+==Things to Look Out For==
-: Please create a horizontal rule between comments on the discussion page by using four dashes <nowiki>----</nowiki> between entries.
+;Do avoid creating empty pages : Please do NOT create blank pages simply as placeholders. Once the pages are created, they are live, and any links to them will then work. When a user clicks their way to an empty page, they have just wasted some of their time. PLEASE - only create pages when you have some content to put into them. You need not have a complete page, but there should be something of value there for users. '''''Thank you!'''''
-:Add four ~s to add your "signature" with a time-stamp -- useful for discussion pages OR just click on the signature icon at the top of the edit window...it's the second one from the right.
-'''Have fun. :)'''
+;'''Do avoid sub-pages''' : Our standard is to '''NOT''' create any sub-pages, EXCEPT for personal pages of Wiki Users and for the Template Tags.  These are pages with a "/" in the title.  If there is a "User:GoodRollin" page, then a sub-page is "User:GoodRollin/My Sub Page". You can use these pages for your sandbox when you create subpages from your User but they are not appropriate for the rest of the site at this time.  '''''Thank you!'''''
-|}
-{| cellspacing=3 width="100%"
+;Do avoid CamelCase for page titles: : For example, if you want to create a page named "About Emakina", you can type <code><nowiki>http://research.emakina.net/About_Emakina</nowiki></code> into your address bar, and the new page will automatically be created. When you wish to link to a created page, create the link with the Wiki format of: <code><nowiki>[[About Emakina]]</nowiki></code> and not the CamelCase <code><nowiki>[[AboutUs]]</nowiki></code>.  '''''Thank you!'''''
-|colspan="2" style="border: 1px dashed black;padding-left:1em;padding-right:0.5em; background: #eee;"|
+Duplicate pages...
+{| cellspacing=3 width="100%"
+|-
+|colspan="2" style="border: 1px dashed black;padding-left:1em;padding-right:0.5em; background: #FFC9D0;"|
-= Pages Created =
+===What Not To Do ===
+Wikis are really great for working collaboratively with a large group of people.  Many wikis, like [http://wikipedia.org Wikipedia] have millions of editors.  This is not Wikipedia.  We have only a few administrators, perhaps a hundred editors, and a lot of visitors looking for what would often be considered very specific information.  Because of this it is very important that we are clear that spamming is not tolerated, and that your account will be blocked if you are caught in the act of any of the following activities.
-This section might help reduce duplicated work :)
+;Do not post malicious code : It's not nice; you and your IP will be blocked.
-Check the following listing of all posts, or search first, before adding new pages.
+;Do not link to commercial products : Commercial links have no place on this wiki.  You will be warned and your articles will be deleted.  A second offense and you and your IP will be blocked.
-* [http://p2pfoundation.net/index.php?title=Special:Allpages&from=ASP All pages] or [[Special:Allpages&from=ASP|All pages]]
+|-
-** (explain the differnces between the two groups of all pages)
+|colspan="2" style="border: 1px dashed black;padding-left:1em;padding-right:0.5em; background: #9EFF91;"|
+===Following Up===
+If you have any questions that you can't find the answers to you can visit the [[Help talk:Contents | discussion tab above]] and leave a note.  Be sure to sign your note with four dashes '~' which will put your name in and a link to your User page.  You can also use the button that has a squiggle of cursive writing on it to sign your note.
+|}
-But don't worry too much about it! Dive in and start learning and working here, the community will help direct you. :-)
+[[Category:P2P Foundation Wiki How-To]]