Diff for "WikiToDo"


Differences between revisions 38 and 39
Revision 38 as of 2006-02-23 12:11:03
Size: 8408
Editor: 203-206-49-178
Comment: re-organised ToDo pages
Revision 39 as of 2006-03-14 12:03:20
Size: 6903
Editor: 203-206-49-178
Comment: restructured page to focus on WikiCleanupProposal
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
This page lists all content-related tasks for the wiki. ||<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:
See WikiTeam WikiToDo lists the various areas of the Ubuntu Wiki that need WikiTeam and general community attention.
Line 5: Line 5:
== Special Love Needed == == Wiki Cleanup Proposal ==
Line 7: Line 7:
The following documents/topics are areas of the wiki which need a lot of love, and reorganisation. The WikiCleanupProposal is the result of consultation with the greater Ubuntu community on what needs improvement in the Ubuntu Wiki. The emphasis of the proposal is to restructure the Wiki into a high-quality documentation source that encourages Ubuntu users to use and contribute to.

=== Populate ===

The next logical step after restructuring the UserDocumentation page is to "fill" the sub-pages that are linked-to off the main page. The suggested method to populate the pages is to search the Wiki on page title names with keywords related to the page.

eg. "print" returns AutomaticPrinterConfiguration, HPPrinterInstallation, HowToXeroxPrinters, HpPrinterInstallationAndMaintenanceBreezy, HpPscHpPhotosmartSeriesAllInOnePrinters, NetworkPrintingFromMacOSX, NetworkPrintingFromWin2000, NetworkPrintingFromWinXP, NetworkPrintingFromWindows, PrinterSharing, WindowsXPPrinter and XeroxPrintersHowto

After the search, each document should be examined to check that it is a document, that it meets a minimum standard and is not a repetitive effort of another document. Once a document matches these simple rules, it should be placed on the correct sub-page of UserDocumentation. A secondary stage of the populating could be to perform a search on text with related keywords, however, this is a much larger task.

The following sub-pages are in need of extra links:

 * [:Printers]
 * [:Sound]
 * [:Multimedia] - mostly the Graphics section
 * most of the other "newer" pages are in need of review

=== Versioning ===

A concerted effort needs to be made to improve the way version-specific documents exist in the Wiki. Starting from the sub-pages of UserDocumentation, a cleanup needs to be made to ensure that an end-user does not get confused about the version a document applies to. The cleanup will include removing documents from the sub-pages that are clearly irrelevant to the current, previous or development version.

Pages that are not version-neutral (can be used for all versions) or are not applicable to the current version are to be flagged with a short alert message at the top of the document - notifying the reader what version the document applies to. The creation of version-specific icons (the iconic Badger-Badger-Badger head for Breezy) would also aid in the versioning overhaul.

=== General Guides ===

The MultimediaApplications page is an excellent example of how to outline a specific grouping of applications available on Ubuntu. Below is a list of similar pages that there is a need for:

==== Multimedia & Graphics ====
 * MultimediaTools - High-level page straight off UserDocumentation to redirect to guides such as CDRipping, DVDAuthoring and MultimediaKeys

 * GraphicsApplications - Similar page to MultimediaApplications, with references to TheGimpHowTo and other apps like gThumb, EoG, etc..

==== Internet & Networking ====

 * EmailClients - group guides based on Email Client - also include an introductory page for each available Email Client

 * InternetApplications - similar page to MultimediaApplications, with sections dedicated to IM, IRC, VOIP and P2P

 * NetworkServices - similar page to MultimediaApplications, with sections dedicated to the setting up of DNS, DHCP, Monitoring, etc..

 * WirelessNetworking - high-level page with brief explanations and guides for WiFi, Bluetooth, Broadband Wireless and ir.

 * RemoteFilesystems - guides to connect to remote fileservers, includes NFS, Samba, iFolder, rsync and WebDAV

 * RemoteAccess - guides to connect to remote machines, includes SSH, VNC, nX, etc..

==== Accessories ====

 * FileTools - introduction to file tools such as archiving and compression tools

==== Games ====

 * GnomeGames - list of all games, with very brief introductions, that are being shipped with DapperDrake

 * UbuntuGames - contains a link to GnomeGames to briefly describe each Gnome Game then contains the extra games grouped into categories - Adventure, Simulation, Arcade, etc.. - to make a higher quality framework for Ubuntu Games doco (in addition to renaming the current UbuntuGames to UbuntuGamesDotOrg)

 * WindowsGames - expands on the very brief section in the current Games page - also needs to be written in an evangelical undertone to really drive home that all games can work under Ubuntu (throw out your copy of Windows, gamers!!)

==== Office ====

 * OpenOffice - contains short sections about each of the OOo components and is a placeholder for OOo guides

 * OfficeApplications - outlines the other apps that can be installed in Ubuntu (dia, planner, gnucash, etc..)

==== Servers ====

 * WebServers - contains guides on how to setup Apache, PHP, SSL, etc..

 * DatabaseServers - introductions and guides to the databases available in Ubuntu (MySQL, PostgresSQL, Oracle)

 * FilePrintServers - guides on setting up Samba, CUPS, WebDAV, etc..

 * CollaborationServers - guides on setting various CollaborationServers such as OpenGroupware, Hula, Sun Java Enterprise System, etc..

 * ContentManagementServers - guides on setting up Wiki and CMS Servers such as MoinMoin and Plone

 * MonitoringServers - guides on setting up monitoring servers such as MRTG, Nagios, Zabbix, etc..

==== Programming ====

 * TextEditors - introductions to text editors such as gedit, vi, emacs, etc with help on setting up syntax highlighting, etc..

 * DevelopmentEnvironments - guides on setting development environments such as Java, Mono, MATLAB, etc..

==== Graphical Environments ====

 * AlternativeDesktops - brief descriptions of Kubuntu and Xubuntu with links to their main pages

==== OS Compatibility ====

 * WindowsCompatibility - guides on setting up Windows Compatible environments such as Wine, Cedega and CrossoverOffice

 * VMWare - description of VMWare's capabilities and links to the VMWare docs that are available

== Cleanups ==

The important pages below are in need of a thorough cleanup:
Line 13: Line 109:
The following documents are part of the WikiCleanupProposal and need extra work:

==== System Administration & Maintenance ====

 * SystemAdministration - guides on various system administration & maintenance tasks - ~- see UserDocumentationBeta for more info -~

==== System Configuration ====

 * LinuxConfiguration - configuration guides on everything other than the desktop environment, includes topics such as kernel and boot configuration - ~- see UserDocumentationBeta for more info -~

 * DesktopConfiguration - contains guides on configuring the desktop environment - ~- see UserDocumentationBeta for more info -~

==== Security ====

 * SecurityGuides - contains general security guides for Ubuntu - ~- see UserDocumentationBeta for more info -~

 * SecurityTools - guides on setting up various security tools - ~- see UserDocumentationBeta for more info -~

==== Hardware ====

 * [:Drives] - guides on installing and managing drives such as hard drives, optical drives and tape drives - ~- see UserDocumentationBeta for more info -~

 * [:Partitions] - guides on setting up and managing different partition types with various tools - ~- see UserDocumentationBeta for more info -~

 * [:Keyboard] - guides on installing and configuring keyboards - ~- see UserDocumentationBeta for more info -~

 * [:Mouse] - guides on installing and configuring mice - ~- see UserDocumentationBeta for more info -~

 * NetworkDevices - guides on installing and managing network devices such as NICs - ~- see UserDocumentationBeta for more info -~

 * InternetDevices - guides on installing and managing Internet devices such as dialup and ADSL modems - ~- see UserDocumentationBeta for more info -~

 * [:Printers] - general page on configuring and managing printers - ~- see UserDocumentationBeta for more info -~

 * [:Sound] - guides on installing old sound cards and troubleshooting sound issues - ~- see UserDocumentationBeta for more info -~

 * [:Video] - guides on installing and managing video cards - ~- see UserDocumentationBeta for more info -~

 * [:TV] - guides on installing TV tuner cards and setting up MythTV, Freevo, etc.. - ~- see UserDocumentationBeta for more info -~

 * ThinClients - guides on setting up and managing thin-client architectures such as LTSP and SunRay - ~- see UserDocumentationBeta for more info -~

== These documents need more work ==
The list is autogenerated from pages with CategoryCleanup on them. Add or remove that category as needed.
The following list is autogenerated from pages with CategoryCleanup on them. Add or remove that category as needed.
Line 60: Line 113:
== These documents need to be expanded == == Expansion ==
Line 65: Line 118:

== These documents do not yet exist ==

Feel free to adopt, move them up after you create them.

=== These documents are needed to create a series of sub-indexes of the Wiki ===

==== Multimedia & Graphics ====
 * MultimediaTools - High-level page straight off UserDocumentation to redirect to guides such as CDRipping, DVDAuthoring and MultimediaKeys - ~- see UserDocumentationBeta for more info -~

 * GraphicsApplications - Similar page to MultimediaApplications, with references to TheGimpHowTo and other apps like gThumb, EoG, etc.. - ~- see UserDocumentationBeta for more info -~

==== Internet & Networking ====

 * EmailClients - group guides based on Email Client - also include an introductory page for each available Email Client - ~- see UserDocumentationBeta for more info -~

 * InternetApplications - similar page to MultimediaApplications, with sections dedicated to IM, IRC, VOIP and P2P - ~- see UserDocumentationBeta for more info -~

 * NetworkServices - similar page to MultimediaApplications, with sections dedicated to the setting up of DNS, DHCP, Monitoring, etc.. - ~- see UserDocumentationBeta for more info -~

 * WirelessNetworking - high-level page with brief explanations and guides for WiFi, Bluetooth, Broadband Wireless and ir. - ~- see UserDocumentationBeta for more info -~

 * RemoteFilesystems - guides to connect to remote fileservers, includes NFS, Samba, iFolder, rsync and WebDAV - ~- see UserDocumentationBeta for more info -~

 * RemoteAccess - guides to connect to remote machines, includes SSH, VNC, nX, etc.. - ~- see UserDocumentationBeta for more info -~

==== Accessories ====

 * FileTools - introduction to file tools such as archiving and compression tools - ~- see UserDocumentationBeta for more info -~

==== Games ====

 * GnomeGames - list of all games, with very brief introductions, that are being shipped with DapperDrake

 * UbuntuGames - contains a link to GnomeGames to briefly describe each Gnome Game then contains the extra games grouped into categories - Adventure, Simulation, Arcade, etc.. - to make a higher quality framework for Ubuntu Games doco (in addition to renaming the current UbuntuGames to UbuntuGamesDotOrg) - ~- see UserDocumentationBeta for more info -~

 * WindowsGames - expands on the very brief section in the current Games page - also needs to be written in an evangelical undertone to really drive home that all games can work under Ubuntu (throw out your copy of Windows, gamers!!) - ~- see UserDocumentationBeta for more info -~

==== Office ====

 * OpenOffice - contains short sections about each of the OOo components and is a placeholder for OOo guides - ~- see UserDocumentationBeta for more info -~

 * OfficeApplications - outlines the other apps that can be installed in Ubuntu (dia, planner, gnucash, etc..) - ~- see UserDocumentationBeta for more info -~

==== Servers ====

 * WebServer - contains guides on how to setup Apache, PHP, SSL, etc.. - ~- see UserDocumentationBeta for more info -~

 * DatabaseServer - introductions and guides to the databases available in Ubuntu (MySQL, PostgresSQL, Oracle) - ~- see UserDocumentationBeta for more info -~

 * FilePrintServer - guides on setting up Samba, CUPS, WebDAV, etc.. - ~- see UserDocumentationBeta for more info -~

 * CollaborationServer - guides on setting various CollaborationServers such as OpenGroupware, Hula, Sun Java Enterprise System, etc.. - ~- see UserDocumentationBeta for more info -~

 * ContentManagementServer - guides on setting up Wiki and CMS Servers such as MoinMoin and Plone - ~- see UserDocumentationBeta for more info -~

 * MonitoringServer - guides on setting up monitoring servers such as MRTG, Nagios, Zabbix, etc.. - ~- see UserDocumentationBeta for more info -~

==== Programming ====

 * TextEditors - introductions to text editors such as gedit, vi, emacs, etc with help on setting up syntax highlighting, etc.. - ~- see UserDocumentationBeta for more info -~

 * DevelopmentEnvironments - guides on setting development environments such as Java, Mono, MATLAB, etc.. - ~- see UserDocumentationBeta for more info -~

==== Graphical Environments ====

 * AlternativeDesktops - brief descriptions of Kubuntu and Xubuntu with links to their main pages - ~- see UserDocumentationBeta for more info -~

==== OS Compatibility ====

 * WindowsCompatibility - guides on setting up Windows Compatible environments such as Wine, Cedega and CrossoverOffice - ~- see UserDocumentationBeta for more info -~

 * [:MacOSCompatibility] - guides on setting up MacOS Compatible environments using PearPC - ~- see UserDocumentationBeta for more info -~

 * VMWare - description of VMWare's capabilities and links to the VMWare docs that are available - ~- see UserDocumentationBeta for more info -~

== These documents are considered done ==
Open for peer review, let us know if something needs change! Please write to ubuntu-doc@lists.ubuntu.com These documents will be released as documentation with Ubuntu if they are thought to be suitable.

 * ["SSHHowto"]
 * BreakMyUbuntu
 * CronHowto
 * ["XChatHowto"]
 * ["AptGetHowTo"]

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

Wiki Cleanup Proposal

The WikiCleanupProposal is the result of consultation with the greater Ubuntu community on what needs improvement in the Ubuntu Wiki. The emphasis of the proposal is to restructure the Wiki into a high-quality documentation source that encourages Ubuntu users to use and contribute to.

Populate

The next logical step after restructuring the UserDocumentation page is to "fill" the sub-pages that are linked-to off the main page. The suggested method to populate the pages is to search the Wiki on page title names with keywords related to the page.

eg. "print" returns AutomaticPrinterConfiguration, HPPrinterInstallation, HowToXeroxPrinters, HpPrinterInstallationAndMaintenanceBreezy, HpPscHpPhotosmartSeriesAllInOnePrinters, NetworkPrintingFromMacOSX, NetworkPrintingFromWin2000, NetworkPrintingFromWinXP, NetworkPrintingFromWindows, PrinterSharing, WindowsXPPrinter and XeroxPrintersHowto

After the search, each document should be examined to check that it is a document, that it meets a minimum standard and is not a repetitive effort of another document. Once a document matches these simple rules, it should be placed on the correct sub-page of UserDocumentation. A secondary stage of the populating could be to perform a search on text with related keywords, however, this is a much larger task.

The following sub-pages are in need of extra links:

  • [:Printers]
  • [:Sound]
  • [:Multimedia] - mostly the Graphics section
  • most of the other "newer" pages are in need of review

Versioning

A concerted effort needs to be made to improve the way version-specific documents exist in the Wiki. Starting from the sub-pages of UserDocumentation, a cleanup needs to be made to ensure that an end-user does not get confused about the version a document applies to. The cleanup will include removing documents from the sub-pages that are clearly irrelevant to the current, previous or development version.

Pages that are not version-neutral (can be used for all versions) or are not applicable to the current version are to be flagged with a short alert message at the top of the document - notifying the reader what version the document applies to. The creation of version-specific icons (the iconic Badger-Badger-Badger head for Breezy) would also aid in the versioning overhaul.

General Guides

The MultimediaApplications page is an excellent example of how to outline a specific grouping of applications available on Ubuntu. Below is a list of similar pages that there is a need for:

Multimedia & Graphics

Internet & Networking

Accessories

  • FileTools - introduction to file tools such as archiving and compression tools

Games

  • GnomeGames - list of all games, with very brief introductions, that are being shipped with DapperDrake

  • UbuntuGames - contains a link to GnomeGames to briefly describe each Gnome Game then contains the extra games grouped into categories - Adventure, Simulation, Arcade, etc.. - to make a higher quality framework for Ubuntu Games doco (in addition to renaming the current UbuntuGames to UbuntuGamesDotOrg)

  • WindowsGames - expands on the very brief section in the current Games page - also needs to be written in an evangelical undertone to really drive home that all games can work under Ubuntu (throw out your copy of Windows, gamers!!)

Office

  • OpenOffice - contains short sections about each of the OOo components and is a placeholder for OOo guides

  • OfficeApplications - outlines the other apps that can be installed in Ubuntu (dia, planner, gnucash, etc..)

Servers

Programming

  • TextEditors - introductions to text editors such as gedit, vi, emacs, etc with help on setting up syntax highlighting, etc..

  • DevelopmentEnvironments - guides on setting development environments such as Java, Mono, MATLAB, etc..

Graphical Environments

  • AlternativeDesktops - brief descriptions of Kubuntu and Xubuntu with links to their main pages

OS Compatibility

  • WindowsCompatibility - guides on setting up Windows Compatible environments such as Wine, Cedega and CrossoverOffice

  • VMWare - description of VMWare's capabilities and links to the VMWare docs that are available

Cleanups

The important pages below are in need of a thorough cleanup:

The following list is autogenerated from pages with CategoryCleanup on them. Add or remove that category as needed.

FullSearch(CategoryCleanup)

Expansion

These are documents that are formatted correctly but simply need to be expanded to cover the full topic.

FullSearch(CategoryNeedsExpansion)

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