|
Size: 2178
Comment: mention RecentChanges
|
Size: 3378
Comment: Added some tentative policy about homepages.
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 1: | Line 1: |
| = Contributing to the Mercurial wiki = | #pragma section-numbers 2 |
| Line 3: | Line 3: |
| You should be aware that your IP address is logged and publicly viewable when you edit a page (even if you are logged in). | = Contributing to the Mercurial Wiki = |
| Line 5: | Line 5: |
| If you edit a page and decide to abandon your edit, please click the "cancel" button above the edit window. This will clear out the edit warning lock others will get while you edit a page. To see the history of all edits made to a page, click on the "info" link on the top. | {i} Unlike some wikis, this wiki is not intended for interactive discussion - please use the [[MailingLists|mailing lists]] for questions. <<TableOfContents>> This page is to introduce you to contributing to the Mercurial wiki. For more basic help, see HelpOnEditing and SyntaxReference. For more extensive contributions, please see our [[WikiStyleGuide|style guide]] and [[WikiCleanup|cleanup guide]]. |
| Line 9: | Line 13: |
| Basic help about editing the wiki is shown below the edit window when you edit any page. The most important wiki editing help pages are HelpOnEditing, SyntaxReference and WikiStyleGuide. | {i} You should be aware that your IP address is logged and publicly viewable when you edit a page (even if you are logged in). Just about all pages on this wiki are editable by you! If you spot a typo, factual error, or other problem, you can fix it yourself immediately. To edit a page, simply click the 'Edit' link on the upper left of most pages. If you haven't logged in, you'll be prompted to create an account which you can later use to subscribe to page changes and set wiki preferences. Basic help about editing the wiki is shown below the edit window when you edit any page. More info can be found at HelpOnEditing, SyntaxReference and WikiStyleGuide. |
| Line 14: | Line 23: |
| [[ChangeSet|this is a link to the page ChangeSet]] | [[UnderstandingMercurial|some basic Mercurial concepts]] |
| Line 17: | Line 26: |
| which looks like this: [[ChangeSet|this is a link to the page ChangeSet]]. You can omit the link text: | which looks like this: [[UnderstandingMercurial|some basic Mercurial concepts]]. You can omit the link text: |
| Line 20: | Line 29: |
| [[ChangeSet]] | [[UnderstandingMercurial]] |
| Line 23: | Line 32: |
| which makes the link look like this: [[ChangeSet]] (the link text is the page name if it is omitted). | which makes the link look like this: [[UnderstandingMercurial]] |
| Line 25: | Line 34: |
| So the syntax is: | Words in 'camel case' (like this: {{{UnderstandingMercurial}}}) are linked too (UnderstandingMercurial) without using the {{{[[..]]}}}, but using descriptive text is generally preferred. |
| Line 27: | Line 36: |
| {{{ [[PageName|text to show for link]] }}} |
== Creating new pages == |
| Line 31: | Line 38: |
| Words in camel case (like this: {{{CamelCase}}}) are linked too (CamelCase) without using the {{{[[..]]}}}. If you don't want a camel cased word to be linked put a {{{!}}} in front of it: !CamelCase. | <!> Before creating a new page, first search for similar content using [[FindPage]]. Then see the [[WikiStyleGuide|wiki style guide]] for some guidelines on naming and creating new pages. |
| Line 33: | Line 40: |
| The easiest way to create a new page is to first insert a link to that new page on an existing page, then click the link and you will get a list of templates for new pages. | The easiest way to create a new page is to first insert a link to that new page on an existing page, then click the link and you will get a list of templates for new pages. You can also start a new page by entering the name of the new page in the "Go To Page" input field on the bottom of !FindPage. Test edits can be made in the [[WikiSandBox]]. You should also consider creating a page matching your account name to tell other wiki users and editors who you are and how to reach you. See CategoryHomepage for examples. |
| Line 35: | Line 43: |
| Note: as a convention, we don't use spaces in page names on this wiki. | === Creating a homepage === |
| Line 37: | Line 45: |
| To search for a page, go to [[FindPage]]. You can also start a new page by entering the name of the new page in the "Go To Page" input field on the bottom of !FindPage. | Please only create a homepage if you have contributed content to this wiki and would like to publish your contact details for other wiki users. Homepages should concern themselves only with a person's Mercurial-related activity: general homepage hosting is widely available on the Internet, and it is not this site's purpose to offer such services. |
| Line 39: | Line 47: |
| Test edits can be made in the [[WikiSandBox]]. | Please use the HomepageTemplate when creating your homepage so that it belongs to CategoryHomepage. |
| Line 41: | Line 49: |
| Check RecentChanges to see all recent changes to the wiki. | == Helping out more == |
| Line 43: | Line 51: |
| Mercurial is a the creation of volunteers like you. If you'd like to help improve the wiki, start by checking RecentChanges to see all recent changes to the wiki and review them for spam and make additional improvements. Visit WikiCleanup for further ideas. | |
| Line 44: | Line 53: |
| == Translating pages == If you create translations, please add the [[http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes|iso-639-1 language code]] on top of the page (see [[HelpOnLanguages]]). For example, on a page written in Italian add {{{ #language it }}} on the first line of the wiki text of the page. |
== See also == * The [[WikiStyleGuide|wiki style guide]] * Our [[WikiCleanup|wiki clean-up]] project |
Contributing to the Mercurial Wiki
Unlike some wikis, this wiki is not intended for interactive discussion - please use the mailing lists for questions.
Contents
This page is to introduce you to contributing to the Mercurial wiki. For more basic help, see HelpOnEditing and SyntaxReference. For more extensive contributions, please see our style guide and cleanup guide.
1. Some first help on wiki editing
You should be aware that your IP address is logged and publicly viewable when you edit a page (even if you are logged in).
Just about all pages on this wiki are editable by you! If you spot a typo, factual error, or other problem, you can fix it yourself immediately. To edit a page, simply click the 'Edit' link on the upper left of most pages. If you haven't logged in, you'll be prompted to create an account which you can later use to subscribe to page changes and set wiki preferences.
Basic help about editing the wiki is shown below the edit window when you edit any page. More info can be found at HelpOnEditing, SyntaxReference and WikiStyleGuide.
Links to other wiki pages can be created like this:
[[UnderstandingMercurial|some basic Mercurial concepts]]
which looks like this: some basic Mercurial concepts. You can omit the link text:
[[UnderstandingMercurial]]
which makes the link look like this: UnderstandingMercurial
Words in 'camel case' (like this: UnderstandingMercurial) are linked too (UnderstandingMercurial) without using the [[..]], but using descriptive text is generally preferred.
2. Creating new pages
Before creating a new page, first search for similar content using FindPage. Then see the wiki style guide for some guidelines on naming and creating new pages.
The easiest way to create a new page is to first insert a link to that new page on an existing page, then click the link and you will get a list of templates for new pages. You can also start a new page by entering the name of the new page in the "Go To Page" input field on the bottom of FindPage. Test edits can be made in the WikiSandBox. You should also consider creating a page matching your account name to tell other wiki users and editors who you are and how to reach you. See CategoryHomepage for examples.
2.1. Creating a homepage
Please only create a homepage if you have contributed content to this wiki and would like to publish your contact details for other wiki users. Homepages should concern themselves only with a person's Mercurial-related activity: general homepage hosting is widely available on the Internet, and it is not this site's purpose to offer such services.
Please use the HomepageTemplate when creating your homepage so that it belongs to CategoryHomepage.
3. Helping out more
Mercurial is a the creation of volunteers like you. If you'd like to help improve the wiki, start by checking RecentChanges to see all recent changes to the wiki and review them for spam and make additional improvements. Visit WikiCleanup for further ideas.
4. See also
The wiki style guide
Our wiki clean-up project