Difference between revisions of "Wiki TODO"

From Pandora Wiki
Jump to: navigation, search
m (see also my todo list. also fixed the header sizes.)
(Merged Getting involved page)
Line 1: Line 1:
 +
== THE FOLLOWING IS THE GETTING INVOLVED PAGE == It was merged into here since this was the more descriptive pagetitle
 +
 +
= The Wiki =
 +
 +
Helping to keep a wiki up to date is easier than you may think.
 +
 +
One of the fears some new contributors have is that they will mess up the page or that they'll make a change which many disagree with.
 +
 +
:; Don't be afraid, be bold!
 +
 +
Discuss complex changes on an article's Talk page.  Getting consensus avoids conflict and enlists aid.
 +
 +
Changes can be easily updated or reverted.  As long as you put a bit of thought into your changes, nobody will complain.
 +
 +
Always remember to take advantage of the "show preview" button when editing and review your changes, to verify your changes before saving them.
 +
 +
== Syntax ==
 +
 +
If all you can do is write, that's enough.  For more complex editing, you can use wiki syntax.  If you understand forum BBCode, you can easily understand wiki syntax.
 +
 +
Editing a wiki page isn't always a simple task, but don't worry, there are many sources of help for you to turn to.
 +
 +
* The [http://en.wikipedia.org/wiki/Wikipedia_Help Wikipedia help] page contains very comprehensive documentation for wiki editing. Sections of interest there would be the [http://en.wikipedia.org/wiki/Help:Contents/Getting_started getting started] page, or the [http://en.wikipedia.org/wiki/Help:Contents/Editing_Wikipedia editing Wikipedia] page.
 +
 +
* The [http://en.wikipedia.org/wiki/Wikipedia%3ACHEATSHEET Wikipedia cheatsheet] contains a summary of the markup used while editing pages.
 +
 +
* The discussion pages (every wiki page has it's own discussion page) can be used to ask for help or feedback. If you want, you could even post a rough draft of what you want to add to the page so others can review it before you add it. The discussion page can be found by clicking the "discussion" tab on the top of the page.
 +
 +
* Also, you can always look at the source of another wiki page to use as an example.
 +
 +
=Guidelines=
 +
 +
Some basic guidelines to keep in mind when editing:
 +
 +
# Keep it Pandora-specific
 +
#* You can link to outside non-Pandora information, but don't duplicate it in the wiki.
 +
# Add links of keywords (easier to jump to further details)  {{FIXME|What does this mean?}}
 +
# Add Categories
 +
 +
== What needs to be done? ==
 +
 +
So, you feel confident enough to edit a page and make updates to it? Great! A good place to look for tasks which need to be completed is the [[Wiki TODO]] page. Feel free to contribute anything you feel is useful, even if it isn't on the To-Do list.
 +
 +
You may find it easier to start with small changes. Updating entries on the one of the lists ([[Games]], [[Emulator list]], [[Software projects]], etc.) we maintain is a good place to start. What may also be a good idea is simply reading the wiki and updating things which seem out of date or incorrect. Fixing spelling mistakes, errors in grammar, or rewriting sentences to make them read nicer can also be good tasks to start with.
 +
 +
If you find any [[:Category:Spam|spam]] pages, please add "<nowiki>[[Category:Spam]]</nowiki>" to the page. This is to make it easier for admins to find and remove it.
 +
 +
Use one of the following labels to indicate to readers and editors what you think about an article:
 +
 +
* [[:Template:OutOfDate]]
 +
* [[:Template:Move]]
 +
* [[:Template:Merge]]
 +
* [[:Template:Split section]]
 +
 +
If you need help with a wiki project, maybe add it to [[Wiki TODO]]! You can also use the [[Talk:Wiki TODO]] to share your idea and get feedback.
 +
 +
Any changes which could potentially be seen as controversial should preferably be discussed on the corresponding discussion/talk section for that page before being made. This is for everyone's benefit as it is counter-productive to have to revert changes that someone may have spent a fair bit amount of time on. If you suggest it and nobody objects, you can assume that it's safe to proceed.
 +
 +
= Finding bugs =
 +
 +
This wiki is for documentation.. not for reporting, troubleshooting or discussing Pandora hardware or software issues.
 +
 +
If you think you have found a bug, search the [http://bugs.openpandora.org/ Bug Tracker] to see if someone else has had a similar problem.
 +
 +
* If you found an existing bug report, read its comments and see if you can contribute something new.
 +
** Subscribe to the bug to be emailed when anyone else comments or the issue is resolved.
 +
 +
* If you cannot find a bug report on your problem, then add one.
 +
** [[Reporting bugs]] gives the best way to use the bug tracker.
 +
 +
= Forums =
 +
This is by far the easiest way to get involved with the Pandora community. There are a number of different communities to join, you can find them on the [[Community Links]] page. These forum communities cover a range of languages, not just English.
 +
 +
[[Category:Wiki]]
 +
[[Category:Community]]
 +
 +
 +
== THE FOLLOWING IS WHAT WAS ON THIS PAGE ==
 +
 
This page is intended for anyone who wants to help the wiki, but isn't quite sure what needs to be done.
 
This page is intended for anyone who wants to help the wiki, but isn't quite sure what needs to be done.
  

Revision as of 11:58, 12 September 2013

== THE FOLLOWING IS THE GETTING INVOLVED PAGE == It was merged into here since this was the more descriptive pagetitle

The Wiki

Helping to keep a wiki up to date is easier than you may think.

One of the fears some new contributors have is that they will mess up the page or that they'll make a change which many disagree with.

Don't be afraid, be bold!

Discuss complex changes on an article's Talk page. Getting consensus avoids conflict and enlists aid.

Changes can be easily updated or reverted. As long as you put a bit of thought into your changes, nobody will complain.

Always remember to take advantage of the "show preview" button when editing and review your changes, to verify your changes before saving them.

Syntax

If all you can do is write, that's enough. For more complex editing, you can use wiki syntax. If you understand forum BBCode, you can easily understand wiki syntax.

Editing a wiki page isn't always a simple task, but don't worry, there are many sources of help for you to turn to.

  • The discussion pages (every wiki page has it's own discussion page) can be used to ask for help or feedback. If you want, you could even post a rough draft of what you want to add to the page so others can review it before you add it. The discussion page can be found by clicking the "discussion" tab on the top of the page.
  • Also, you can always look at the source of another wiki page to use as an example.

Guidelines

Some basic guidelines to keep in mind when editing:

  1. Keep it Pandora-specific
    • You can link to outside non-Pandora information, but don't duplicate it in the wiki.
  2. Add links of keywords (easier to jump to further details)
  3. Add Categories

What needs to be done?

So, you feel confident enough to edit a page and make updates to it? Great! A good place to look for tasks which need to be completed is the Wiki TODO page. Feel free to contribute anything you feel is useful, even if it isn't on the To-Do list.

You may find it easier to start with small changes. Updating entries on the one of the lists (Games, Emulator list, Software projects, etc.) we maintain is a good place to start. What may also be a good idea is simply reading the wiki and updating things which seem out of date or incorrect. Fixing spelling mistakes, errors in grammar, or rewriting sentences to make them read nicer can also be good tasks to start with.

If you find any spam pages, please add "[[Category:Spam]]" to the page. This is to make it easier for admins to find and remove it.

Use one of the following labels to indicate to readers and editors what you think about an article:

If you need help with a wiki project, maybe add it to Wiki TODO! You can also use the Talk:Wiki TODO to share your idea and get feedback.

Any changes which could potentially be seen as controversial should preferably be discussed on the corresponding discussion/talk section for that page before being made. This is for everyone's benefit as it is counter-productive to have to revert changes that someone may have spent a fair bit amount of time on. If you suggest it and nobody objects, you can assume that it's safe to proceed.

Finding bugs

This wiki is for documentation.. not for reporting, troubleshooting or discussing Pandora hardware or software issues.

If you think you have found a bug, search the Bug Tracker to see if someone else has had a similar problem.

  • If you found an existing bug report, read its comments and see if you can contribute something new.
    • Subscribe to the bug to be emailed when anyone else comments or the issue is resolved.
  • If you cannot find a bug report on your problem, then add one.

Forums

This is by far the easiest way to get involved with the Pandora community. There are a number of different communities to join, you can find them on the Community Links page. These forum communities cover a range of languages, not just English.


THE FOLLOWING IS WHAT WAS ON THIS PAGE

This page is intended for anyone who wants to help the wiki, but isn't quite sure what needs to be done.

See also user:spiralofhope/todo

Ongoing

Update lists

  • Legal Emulation Resources - add info from topic onto the page (this is done for the most part, some links could be missing).
  • Take a look at this thread and add anything new to the emulators, games, and software lists.
  • Expand this page: Troubleshooting common problems
    • Looking through the forums and noting what problems seems to come up a lot could be a start. A list could be put in the discussion section of that page if you don't feel comfortable describing how to possibly solve it, or just linking to related topics could be enough for now.
    • For any pages you edit, work out how (knowing the page exists) one would navigate to it from the main page, without searching.

Expand stubs

Find old stub (low content, e.g. Special:ShortPages) pages and merge with more useful ones. Some pages are just forward looking from pre-release and may not be relevant any more.

Lonely pages

Go through and find pages which aren't being linked to anywhere (Special:Specialpages and specifically Special:Lonelypages can help). Find somewhere that makes sense and add a link to the page there... if necessary, make a new page in the style of Tutorials and documentation. There is some discussion about this Talk:Wiki TODO.

Add Categories

Go through and make sure each page has an appropriate category, add categories for pages without.

If you find any spam pages, please add "[[Category:Spam]]" to the page.

Monitor talks/changes

Take a look at the recent talk changes for possible things to do.