Difference between revisions of Help:How to contribute

Viceroy Sam (talk | contribs)
{{Policies and guidelines}}
No edit summary
 
(21 intermediate revisions by 5 users not shown)
Line 1: Line 1:
[[File:Kermit the frog typing.gif|right]]
{{EM help}}
{{gif fixer|[[File:Kermit the frog typing.gif]]|right}}
<center>'''Looking for [[EndMyopia:Policies|wiki policies]]?'''</center>
<center>'''Looking for [[EndMyopia:Policies|wiki policies]]?'''</center>
'''If it ain't broke, don't fix it'''. That is the guiding principle behind this help article ;)
'''If it ain't broke, don't fix it'''. That is the guiding principle behind this help article ;)
'''Notice:''' Editing the wiki is temporarily not available, until we update legal policies, disclaimers and a number of articles.  This has become necessary as some had expressed concerns about various contents, and unlimited public access without possibly necessary limitation and disclaimers.  Jake, who created all of the endmyopia resources had been entirely uninvolved in wiki moderation, which has since caused some issues.
Luckily we've been able to clear the hurdle of being able to have the wiki online.  It'll take some time to get all wiki contents and details in line with updated policies, at which time we hope to be able to re-enable editing.  ❤️


The wiki runs on [https://www.mediawiki.org/wiki/MediaWiki MediaWiki], the same wiki software that powers Wikipedia and probably every other wiki you've come across on the internet. As a result, '''countless other people have written guides far better than we could ever hope to write about how to contribute to the wiki'''. So, no point in reinventing the wheel with this one.
The wiki runs on [https://www.mediawiki.org/wiki/MediaWiki MediaWiki], the same wiki software that powers Wikipedia and probably every other wiki you've come across on the internet. As a result, '''countless other people have written guides far better than we could ever hope to write about how to contribute to the wiki'''. So, no point in reinventing the wheel with this one.
Line 8: Line 13:


Remember that if you're using templates such as <nowiki>{{templatenamehere}}</nowiki>, a lot of them will not work unless the template has been copied over to here in the Template namespace. Bear that in mind if something doesn't work properly :)
Remember that if you're using templates such as <nowiki>{{templatenamehere}}</nowiki>, a lot of them will not work unless the template has been copied over to here in the Template namespace. Bear that in mind if something doesn't work properly :)
==Formatting==
==Formatting==
===Using Wikitext===
===Using Wikitext===
Line 27: Line 31:


Definitely feel free to ignore anything that is more related to being an encyclopedia, we are not an encyclopedia, we are a vision improvement resource, first and foremost, full of funny jokes. You will find a lot of information about how to stylise articles in a cool way there though.
Definitely feel free to ignore anything that is more related to being an encyclopedia, we are not an encyclopedia, we are a vision improvement resource, first and foremost, full of funny jokes. You will find a lot of information about how to stylise articles in a cool way there though.
====EndMyopia specifics====
There is an apparent consensus at the time of writing that 'EndMyopia' should be the consistent capitalisation of how the name is referenced. Please refrain from using different capitalisations when referring to EndMyopia in articles. Consistency is important.


==Creating new pages==
====Using images====
===Creating a new article===
{{Main|Help:Pictures}}
To create a new article, enter in the URL of the article you would like to create. You'll be taken to a page where you will be asked to create the article if it doesn't exist already.
You can upload images to this site using the "upload file" tool in the left panel. (That tool also provides a link to enumerate uploaded fles.)


Alternatively, create a redlink, [[MediaWiki:like this|like this]]. Then click on the redlink to create the article. You can place loads of redlinks in articles that are already written to indicate to others the articles that need writing.
But even better than that, the "InstantCommons" feature seems to be enabled, which means you can access images directly from commons without having to copy them to here. See https://www.mediawiki.org/wiki/InstantCommons#Using_files_via_InstantCommons
===Creating a redirect===
Redirects move anyone who lands at that page to another page. This is used for terms that are similar, like [[Myopia]] and [[Shortsightedness]]. This is really important in preventing duplicate articles covering the same topic, and to aid in navigation of the wiki.


To create a redirect, type the following in the entire body of an article, and nothing else:
====Writing maths====
To write maths, enclose text in <code><nowiki><math></math></nowiki></code> tags.


<code><nowiki>#redirect [[ArticleName]]</nowiki></code>
<code><nowiki><math>(5+12)/(41.9999)</math></nowiki></code> displays as


==Using talk pages==
<math>(5+12)/41.9999</math>
Talk pages are 100% completely identical to normal pages in how they work. You can use all wikitext markup tricks in talk pages, the software does not handle them differently. The following are the basics:


Create subject headers using <code><nowiki>==Subject==</nowiki></code>. Indent your messages in responding to other editors using colons. Sign off your posts with your signature of <nowiki>~~~~</nowiki> as standard. Be sure to notify users using the template <code><nowiki>{{re|User}}</nowiki></code>. For example, a fictional conversation between two editors you might find on the Differentials talk page:
You can use fancy formatting too!


<code><nowiki>==Difference between diffs and normalised==</nowiki><br>
<code><nowiki><math>\frac{1}{2}e^{i\pi} = \frac{-1}{2}</math></nowiki></code> displays as
<nowiki>Hey guys, what should be the advice given about differentials? ~~~~</nowiki><br>
<nowiki>:{{re|User}} Differentials should be 1-2 diopters below your normalised prescription. We should put this in the lead section of the article. ~~~~</nowiki><br>
<nowiki>::{{re|OtherUser}} Oh great, many thanks! ~~~~</nowiki></code>


'''Will be rendered as (with the heading removed):'''
<math>\frac{1}{2}e^{i\pi} = \frac{-1}{2}</math>


Hey guys, what should be the advice given about differentials? [[User:User|User]] ([[User talk:User|talk]]) 13:58, 20 May 2020 (UTC)
For way too much detail on how to write and display formulae, see [https://en.wikipedia.org/wiki/Help:Displaying_a_formula Wikipedia's guide on how to render mathematical formulae].
:{{re|User}} Differentials should be 1-2 diopters below your normalised prescription. We should put this in the lead section of the article. [[User:Other User|OtherUser]] ([[User talk:OtherUser|talk]]) 14:08, 20 May 2020 (UTC)
::{{re|OtherUser}} Oh great, many thanks! [[User:User|User]] ([[User talk:User|talk]]) 14:11, 20 May 2020 (UTC)


You can also press the 'Add topic' button so you don't have to type <code><nowiki>==Topic title==</nowiki></code> before your messages.
====Citing papers====
We want to cite scientific research where possible to justify this approach. One way is to use the ''''proveit'''' gadget that should appear in the bottom right corner while editing - see the video tutorials mentioned above for more details.


As you can see, using talk pages is ridiculously easy. Just remember though: [https://en.wikipedia.org/wiki/Help:Talk_pages anything you can do, Wikipedia can do better Click here for Wikipedia's explanation about talk pages.].
=====Repeating references=====
===Signatures===
It is possible to reference the same document several times from within an article. On the first one, give the reference a tag : <nowiki><ref name="habits">citation here</ref></nowiki>. Then subsequent mentions can simply use the tag with an empty body : <nowiki><ref name="habits"></ref></nowiki>  or xml shorthand <nowiki><ref name=habits" /></nowiki>
Signatures can be configured using the Preferences button in the top right. It's better to keep this as simple as possible, and there's literally nothing wrong with the default signature. Definitely check out [https://en.wikipedia.org/wiki/Wikipedia:Signatures Wikipedia's page on how to customise signatures] if you want to leave your mark a bit more on every talk page you visit. Who doesn't like a colourful talk page?


Again, none of WPs policies apply to signatures, except please do not include images or files in your signatures as they cause unnecessary server load and make talk pages look horrible.
=====Biomedical citation maker=====
Another (external) tool is http://sumsearch.org/cite/ - if you have a unique reference for the journal in one of various formats (such as a <nowiki>https://doi.org/...</nowiki> url), you can enter that into the box and will generate a fancy '''<nowiki><ref>{{cite...}}</ref></nowiki>''' sequence with title, authors, journal, etc. that you can simply paste in.


Posts can be signed off with four tildes or three. Four is by definitely what most people should use in most circumstances. Here's the difference:
It provides a bookmarklet which allows you to generate a citation by simply selecting the doi using mouse, and pressing a button.


<nowiki>~~~~</nowiki>
====EndMyopia specifics====
:[[User:User|User]] ([[User talk:User|talk]]) 14:08, 20 May 2020 (UTC)
There is an apparent consensus at the time of writing that 'EndMyopia' should be the consistent capitalisation of how the name is referenced. Please refrain from using different capitalisations when referring to EndMyopia in articles. Consistency is important.


<nowiki>~~~</nowiki>
==Creating new pages==
:[[User:User|User]] ([[User talk:User|talk]])
===Creating a new article===
To create a new article, enter in the URL of the article you would like to create. You'll be taken to a page where you will be asked to create the article if it doesn't exist already.


Forgetting to use signatures will leave everyone confused really quickly, so please make it a habit to include <nowiki>~~~~</nowiki> at the end of all your messages on talk pages! :)
Alternatively, create a redlink, [[MediaWiki:like this|like this]]. Then click on the redlink to create the article. You can place loads of redlinks in articles that are already written to indicate to others the articles that need writing.
===Creating a redirect===
Redirects move anyone who lands at that page to another page. This is used for terms that are similar, like [[Myopia]] and [[Shortsightedness]]. This is really important in preventing duplicate articles covering the same topic, and to aid in navigation of the wiki.


===Notifying other users===
To create a redirect, type the following in the entire body of an article, and nothing else:
When you reply to a user on any other talk page aside from their own talk page, they won't be notified unless you remember to send a notification template to them. This is super easy to do!!


When responding to people, type the following at the beginning of your message:
<code><nowiki>#redirect [[ArticleName]]</nowiki></code>
 
==Using talk pages==
<code><nowiki>{{re|User}}</nowiki></code>
{{bigger|See [[Help:Talk pages]]}}
 
{{re|User}} is how it is displayed. This will send a notification to the user through the notification system.
 
You can also use <code><nowiki>{{u|User}}</nowiki></code>
 
{{u|User}} is how this one looks, and can be used to mention someone's username without the @ symbol.
 
{{Policies and guidelines}}