Diff for "WikiToDo"

Differences between revisions 1 and 66 (spanning 65 versions)
⇤ ← Revision 1 as of 2005-05-28 21:04:53 →
Size: 2524
Editor: adsl-213-190-44-43
Comment: imported from the old wiki
← Revision 66 as of 2007-09-02 13:24:02 → ⇥
Size: 4001
Editor: CPE-121-208-130-12
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
= WikiToDo = ||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;">'''Contents'''[[BR]][[TableOfContents]]||
Line 3: Line 3:
This page lists all content-related tasks for the wiki. Number ONE To item for this wiki. Everyone neds to change direction, and get hacking it.
'''''This page, and CategoryCleanup, CategoryExpansion pages is an indication about how the Wiki documentation team are failing, hopelessly. None of these pages should exist. There are currently several hundred pages listed in the CategoryCleanup page, and I am certain that many other pages should be on there as well. However the RecentChanges page shows that about 10 pages are edited in a typical day. It is therefore patently obvious that the wiki is NEVER going to be remotely up-to date at this rate. The answer is:
 1. STOP writing lists about what is to be done.
 1. Start IMMEDIATELY changing every single page that you think needs correction. DON'T WORRY IF YOU ARE NOT 100% CORRECT, JUST DO YOUR BEST AND ASSUME THAT OTHERS MIGHT FIX THE BITS THAT YOU GET WRONG. Don't be intimidated by this wiki. Hack it. It won't bite. No-one is going to come round to your house and attack you.
 1. In other words: Stop writing about what needs changing, and just DO THE CHANGES.
Line 5: Line 9:
== General open tasks == In a nutshell, the Documentation Team has tried it this way and its failing. "If you keep doing the same thing and its not working, why do you expect anything to get better?" You need to change your approach, try something DIFFERENT.
Line 7: Line 11:
 * Important: fix up wiki links which may have broken during migration; often, a single set of [brackets] will do the trick.
  * Find and fix links which still point to the old wiki
  * check for orphaned pages and link to relevant sections
  * hunt for links pointing to the old Wiki and have them redirected (see below)
 * Convert all pages to MoinMoin Syntax and deactivate the other input methods...		 See other comments below.'''''
Line 13: Line 13:
 * Complete the WikiPolicy
  * Content License, Copyright
  * What to do with StubArticles, where to move obsolete pages etc.
  * Formal structure of WikiTeam, who maintains the server, who supervises content etc.		 This page lists the various areas of the Ubuntu Wiki that need WikiTeam and general community attention.
Line 18: Line 15:
 * Teams - add copy from the wiki Teams to the website - http://www.ubuntulinux.org/community/teams/ and keep that current.
 * UbuntuCommunity Philosophy - amend the Philosophy page on the website to include copy from http://www.ubuntulinux.org/wiki/UbuntuCommunityPhilosophy
 * (Maybe use a macro to automatically update the pages under support etc.?)
 * Polishing documentation that already ships with Ubuntu?
 * Create a macro to automatically have link on DocPages to the translations.
 * organize the pages below into some kind of useful hierarchy like in IdeasForNewFrontPageStructure. Visit them and use the reparent button or backlinks tab to move them under suitable parent pages.
 * Maybe create a "stubs" page, which contains all pages which need more work.		 == Cleanups ==
''''' So whoever wrote this list should have simply made as much effort as possible on those pages to fix them. Dont waste your time listing them here. That is not achieving anything.'''''
The important pages below are in need of a thorough cleanup:
Line 26: Line 19:
== These documents need more work ==
Feel free to add your docs or notes on progress.		  * Samba - SettingUpSamba
 * ISDN Networking - IsdnHowto, HisaxButNotMISDN, etc.
 * Wacom Tablets - WacomPenPartnerSerial, WacomTabletIssue, and QuickAndDirtyWacomSolution
 * MythTV - there are 3 guides already about MythTV, there should just be one.
 * VMWare - there are far too many guides about VMWare, they need integrating.
 * Postfix - ditto.
 * Kernel - ditto.
Line 29: Line 27:
 * UbuntuBootupHowto
 * EncryptedFilesystemHowto
 * NFSServerHowTo
 * NautilusScriptsHowto
  I think that if this isn't broken down in some simple way it'll end up being a giant script repository. Not necessarily a bad thing, but proper organization would encorage people to either put their script on a totally seperate page or in another, dedicated scripts page.
 * SettingUpSamba
 * Java - needs to be vastly simplified and updated to the new version of sun java, 1.5.0 update 2.
 * InitScriptList		 Also, a list of pages which need more work can be found on the page CategoryCleanup. Feel free to dive into that list, tidy up a page and remove the Cleanup tag!
Line 38: Line 29:
== These documents do not yet exist == == Forum Integration ==
Line 40: Line 31:
Feel free to adopt, move them up after you create them There are lots of good guides posted on the forums every day [http://ubuntuforums.org/forumdisplay.php?f=100 in the howto section]. Often there is material that isn't covered in this wiki. Bringing guides from there into the wiki structure can be really useful - be sure to get the author's permission to release the document into the wiki. For more details, read the ["forum"] page.
##FIXME - this needs to be updated when a licence is decided for the wiki
Line 42: Line 34:
 * How to install Thunderbird from mozilla.org (firefox = done). == Deletion ==
Here you can add names of pages to be nominated for deletion.
''''' So simply delete them. Don't talk about it, DO it. If its a bad idea, someone will bring them back. I would like to delete this page, and the entire CategoryCleanup and CategoryExpansion mechanism.'''''
Line 44: Line 38:
== These documents are considered done ==
Open for peer review, let us know if something needs change!		  * VMware/Workstation/AMD64 - This is an empty page with only "moved".
 * EdubuntuDocumentation/EdubuntuCookbook - pretty old, now known as handbook, currently in svn with new plans for development
 
== Expansion ==
Line 47: Line 43:
 * SSHHowto
 * BreakMyUbuntu
 * CronHowto		 A list of documents that are formatted correctly but simply need to be expanded to cover the full topic can be found at CategoryNeedsExpansion
Line 51: Line 45:
== Moving Documentation from Main Wiki ==
Line 52: Line 47:
== Pages with links pointing to the old Wiki == Many documentation pages get erroneously created on the Main Ubuntu wiki, and need to be moved into this one. This is an easy way to help out! See https://wiki.ubuntu.com/CategoryDocumentation for more details!
Line 54: Line 49:
Add more here if you see them. == Organisation of the Wiki ==

Some ideas about how best to organise the vast amount of documentation on the wiki can be found at ["WikiToDo/Organisation"]

Number ONE To item for this wiki. Everyone neds to change direction, and get hacking it. This page, and CategoryCleanup, CategoryExpansion pages is an indication about how the Wiki documentation team are failing, hopelessly. None of these pages should exist. There are currently several hundred pages listed in the CategoryCleanup page, and I am certain that many other pages should be on there as well. However the RecentChanges page shows that about 10 pages are edited in a typical day. It is therefore patently obvious that the wiki is NEVER going to be remotely up-to date at this rate. The answer is:

  1. STOP writing lists about what is to be done.
  2. Start IMMEDIATELY changing every single page that you think needs correction. DON'T WORRY IF YOU ARE NOT 100% CORRECT, JUST DO YOUR BEST AND ASSUME THAT OTHERS MIGHT FIX THE BITS THAT YOU GET WRONG. Don't be intimidated by this wiki. Hack it. It won't bite. No-one is going to come round to your house and attack you.
  3. In other words: Stop writing about what needs changing, and just DO THE CHANGES.

In a nutshell, the Documentation Team has tried it this way and its failing. "If you keep doing the same thing and its not working, why do you expect anything to get better?" You need to change your approach, try something DIFFERENT.

See other comments below.

This page lists the various areas of the Ubuntu Wiki that need WikiTeam and general community attention.

Cleanups

So whoever wrote this list should have simply made as much effort as possible on those pages to fix them. Dont waste your time listing them here. That is not achieving anything. The important pages below are in need of a thorough cleanup:

Also, a list of pages which need more work can be found on the page CategoryCleanup. Feel free to dive into that list, tidy up a page and remove the Cleanup tag!

Forum Integration

There are lots of good guides posted on the forums every day [http://ubuntuforums.org/forumdisplay.php?f=100 in the howto section]. Often there is material that isn't covered in this wiki. Bringing guides from there into the wiki structure can be really useful - be sure to get the author's permission to release the document into the wiki. For more details, read the ["forum"] page.

Deletion

Here you can add names of pages to be nominated for deletion. So simply delete them. Don't talk about it, DO it. If its a bad idea, someone will bring them back. I would like to delete this page, and the entire CategoryCleanup and CategoryExpansion mechanism.

  • VMware/Workstation/AMD64 - This is an empty page with only "moved".

  • EdubuntuDocumentation/EdubuntuCookbook - pretty old, now known as handbook, currently in svn with new plans for development

Expansion

A list of documents that are formatted correctly but simply need to be expanded to cover the full topic can be found at CategoryNeedsExpansion

Moving Documentation from Main Wiki

Many documentation pages get erroneously created on the Main Ubuntu wiki, and need to be moved into this one. This is an easy way to help out! See https://wiki.ubuntu.com/CategoryDocumentation for more details!

Organisation of the Wiki

Some ideas about how best to organise the vast amount of documentation on the wiki can be found at ["WikiToDo/Organisation"]

WikiToDo (last edited 2009-04-20 23:26:38 by 79-72-55-40)