Difference between revisions of "Using and editing the Freecycle wiki"
| [checked revision] | [checked revision] |
Alisonkamat (talk | contribs) |
Alisonkamat (talk | contribs) |
||
| Line 27: | Line 27: | ||
*Similarly, if something's missing, add it in. | *Similarly, if something's missing, add it in. | ||
| − | If you think an article should exist, create a link to it - that way it will show up when people look for work to do. | + | If you think an article should exist, [[#Creating a new page|create a link to it]] - that way it will show up when people look for work to do. |
== How do I use the editor? == | == How do I use the editor? == | ||
| − | When you click on Edit, you'll see the | + | When you click on Edit, you'll see the wikitext, which uses special characters to format the text. This is a bit cryptic to use, though you'll soon get the hang of it. The toolkit at the top of the page is helpful for most formatting situations. Click on Advanced to access list tools. |
Click below for additional information on: | Click below for additional information on: | ||
*[[Adding a link]] | *[[Adding a link]] | ||
*[[Inserting a screenshot]] | *[[Inserting a screenshot]] | ||
| + | |||
| + | For more information on wikitext, here's a good cheatsheet of [https://en.wikipedia.org/wiki/Help:Cheatsheet basic wikitext codes]. | ||
Click the Preview tab to check your work. When you're done, click the Publish button to save your changes. Don't worry -- your edits won't be public until they're reviewed. | Click the Preview tab to check your work. When you're done, click the Publish button to save your changes. Don't worry -- your edits won't be public until they're reviewed. | ||
| + | |||
| + | === HTML === | ||
| + | |||
| + | HTML code is what is written between the symbols <nowiki> < > </nowiki>. This is used for special formatting situations that wikitext can't handle. You probably won't need these, but here's a good [http://www.webmonkey.com/2010/02/html_cheatsheet/#Text_Tags HTML cheatsheet] just in case. | ||
| + | |||
| + | === Creating a new page === | ||
| + | |||
| + | In your browser, type in <nowiki> https://wiki.freecycle.org/Newpagename </nowiki> to create a page called Newpagename. This brings up an error message: "There is currently no text in this page. You can search for this page title in other pages, search the related logs, or edit this page." The page is now ready to be edited. | ||
== What's the 'house style'? == | == What's the 'house style'? == | ||
| Line 61: | Line 71: | ||
*Don't be afraid to change the structure of a page. If people just add text and sections to a page, it becomes too long; think about whether it needs splitting, editing or rewriting. | *Don't be afraid to change the structure of a page. If people just add text and sections to a page, it becomes too long; think about whether it needs splitting, editing or rewriting. | ||
| + | == Helpful hints == | ||
| + | |||
| + | *The | character is located above the \ key, just under the Backspace key on a typical keyboard. | ||
| + | *Try to avoid editing section headings or page headings. If there's a link somewhere else in the Wiki to that heading, even the slightest change will break the link. | ||
| + | *Remember that the default setting in the wiki is that all pages are visible to the public unless permissions are set to restrict the page to specific users. | ||
| + | *When you're looking at the wiki and see an example of formatting you might like to emulate, click the Edit tab and copy the wikitext to a text document so you can refer to it later. | ||
| + | |||
== Are my edits reviewed? == | == Are my edits reviewed? == | ||
Yes. The wiki shows the approved versions of changes. A separate team of Reviewers will verify your edits and approve them to make them visible to others. | Yes. The wiki shows the approved versions of changes. A separate team of Reviewers will verify your edits and approve them to make them visible to others. | ||
Revision as of 19:57, 20 January 2016
Here's how you can help build this wiki.
Contents
Log In
To edit pages, you have to log in. There's a link towards the top right, and you can log in using your My Freecycle id and password.
Currently only group Moderators and Lead-Moderators can make edits.
What needs doing?
You can find work that needs doing in two ways:
- Find pages which don't exist.
- Browsing.
Missing Pages
- Wikis have clickable links, to take you from one article to another.
- If the article doesn't exist, the link will appear in red.
- You can get a list of articles which don't exist....how?
- Then just click on one, and start editing.
Browsing
- Just wander around the wiki, clicking on links, searching, and so on.
- When you find something that's wrong, fix it - click on the Edit link.
- Similarly, if something's missing, add it in.
If you think an article should exist, create a link to it - that way it will show up when people look for work to do.
How do I use the editor?
When you click on Edit, you'll see the wikitext, which uses special characters to format the text. This is a bit cryptic to use, though you'll soon get the hang of it. The toolkit at the top of the page is helpful for most formatting situations. Click on Advanced to access list tools.
Click below for additional information on:
For more information on wikitext, here's a good cheatsheet of basic wikitext codes.
Click the Preview tab to check your work. When you're done, click the Publish button to save your changes. Don't worry -- your edits won't be public until they're reviewed.
HTML
HTML code is what is written between the symbols < > . This is used for special formatting situations that wikitext can't handle. You probably won't need these, but here's a good HTML cheatsheet just in case.
Creating a new page
In your browser, type in https://wiki.freecycle.org/Newpagename to create a page called Newpagename. This brings up an error message: "There is currently no text in this page. You can search for this page title in other pages, search the related logs, or edit this page." The page is now ready to be edited.
What's the 'house style'?
A few things to bear in mind:
- Please don't use lots of capitals.
- Use bold text rarely, for emphasis.
- Use italics for terminology, or names of buttons/menu items.
- Use red text very rarely, for warnings about very important things.
Remember that this wiki is for members, who may not have strong IT skills, and may not have English as a first language.
- Use simple language.
- Keep sentences short. If they're long, people won't read them.
- Keep articles short. If they're more than a couple of screens, people won't read them. Often articles get cluttered because there's one specific, relatively unimportant, point which takes a long time to explain. Create another article instead, and link to it.
- Use screenshots. Although it's a bit of a pain capturing them and uploading them to the wiki, they're massively more useful than words. See here for how to capture them.
Keep a clear structure:
- Use lots of links, from one article to another. Think about where someone needs to go next, and add links to help them.
- Use bullets and section headings to provide clear, visible structure.
- Don't be afraid to change the structure of a page. If people just add text and sections to a page, it becomes too long; think about whether it needs splitting, editing or rewriting.
Helpful hints
- The | character is located above the \ key, just under the Backspace key on a typical keyboard.
- Try to avoid editing section headings or page headings. If there's a link somewhere else in the Wiki to that heading, even the slightest change will break the link.
- Remember that the default setting in the wiki is that all pages are visible to the public unless permissions are set to restrict the page to specific users.
- When you're looking at the wiki and see an example of formatting you might like to emulate, click the Edit tab and copy the wikitext to a text document so you can refer to it later.
Are my edits reviewed?
Yes. The wiki shows the approved versions of changes. A separate team of Reviewers will verify your edits and approve them to make them visible to others.
