个人工具

“UbuntuHelp:Beginners/Development”的版本间的差异

来自Ubuntu中文

跳转至: 导航, 搜索
 
(未显示同一用户的9个中间版本)
第1行: 第1行:
 
{{From|https://help.ubuntu.com/community/Beginners/Development}}
 
{{From|https://help.ubuntu.com/community/Beginners/Development}}
 
{{Languages|UbuntuHelp:Beginners/Development}}
 
{{Languages|UbuntuHelp:Beginners/Development}}
This page is used by the Beginners Team to communicate ideas
+
This page is used by the Beginners Team Wiki Focus Group to communicate ideas and use for wiki editing organization.
== Tasks ==
+
== Documentation Reservation Area ==
The documentation should always reflect the latest version, and then if there are release specific differences, then those differences and only those differences will be placed into their own pages under the same category, and linked to. So for example if Dapper's codec installation method is different, it should be under Media/Dapper, or Media/Video/Dapper if Video happens to be subclassed.
+
Here is where you can "lay claim" to wiki pages that you want to update or rewrite.  Claimed pages will not be touched by other BT members unless the owner gives permission (say, in IRC).
1. FAQ should be for questions, not every task under the sun. Things from there will need to be shuttled into their own pages, and linked from the guide, or put into some hardware troubleshooter.
+
=== Still Available ===
2. CLI should be minimised, tucked.
+
Pages that have been marked for updating:
3. Eliminate all these pages, by either moving the information into the guide or regular wiki, or eliminating it.
+
{|border="1" cellspacing="0"
Beginners/Guide/Dapper
+
| Page || Interested Users || Comments/Ideas
Beginners/Guide/Edgy
+
|-
Beginners/Guide/Feisty
+
| [[UbuntuHelp:EasyWirelessToWiredConnectionSharing|EasyWirelessToWiredConnectionSharing]] || lukjad007 || Needs cleanup
Beginners/Guide/Feisty/Gaim
+
|-
Beginners/Guide/Feisty/Multimedia
+
|[[UbuntuHelp:Wine|Wine]] ||  || Needs some cleanup, reorganization
4. Things to Add
+
|-
Desktop Guide
+
| Any and all pages relating to bluetooth ||  || Matthew (mdke), the doc team lead, has requested that we look at bluetooth pages if anybody has experience.
*Should probably include how to browse gnome-look/kde-look, save something, and choose it.
+
|-
*Themes -- Do not include Beryl in this, compiz is default.
+
| [[UbuntuHelp:Kubuntu|Kubuntu]] ||  || 
*Engines?
+
|-
*Sounds
+
| [[UbuntuHelp:InitScriptList|InitScriptList]] || Rocket2DMn || 
*Splashes (DE, and possibly usplash)
+
|-
*KDE and XFCE
+
| [[UbuntuHelp:EdubuntuFAQ|EdubuntuFAQ]] || || cleanup, nominated cprofitt based on experience
*Carefully chosen list of professional sites to pick customisations from.
+
|-
Installation of programs, most importantly from Add/Remove Programs. *TODO: Check if any guide exists for this.
+
| [[UbuntuHelp:EdubuntuDocumentation/EdubuntuCookbook/NetworkInstall|Edubuntu Recipes - Network Install]] || || needs expansion
*If possible use programs as an abstraction of packages.
+
|-
 +
| [[UbuntuHelp:NetworkManagementTools|NetworkManagementTools]] ||  || expansion, cleanup. May need to be hooked up with other existing documentation.
 +
|-
 +
| [[UbuntuHelp:BridgingNetworkInterfaces|BridgingNetworkInterfaces]], [[UbuntuHelp:NetworkConnectionBridge|NetworkConnectionBridge]], [[UbuntuHelp:NetworkMonitoringBridge|NetworkMonitoringBridge]] ||  || duplicate documentation, cleanup.  Perhaps link to a central bridging page from all over the docs.  
 +
|-
 +
| [[UbuntuHelp:BluetoothSetup|BluetoothSetup]] ||  || Very outdated, needs to be updated, update bug report accordingly: https://bugs.launchpad.net/bugs/304924
 +
|}
 +
=== Claimed ===
 +
Pages that have been claimed by a user:
 +
{|border="1" cellspacing="0"
 +
| Page || Editor || Comments
 +
|-
 +
| [[UbuntuHelp:RecoveringUbuntuAfterInstallingWindows|RecoveringUbuntuAfterInstallingWindows]] || lukjad007 || cleanup
 +
|-
 +
| [[UbuntuWiki:ksplice|Ksplice]] || lukjad007 || Creation, would like links to documentation.  
 +
|-
 +
| [[UbuntuHelp:DesktopEffects|DesktopEffects]] || Rocket2DMn || general re-org for DE pages
 +
|-
 +
| [[UbuntuHelp:GnuPrivacyGuardHowto]] || [[UbuntuWiki:thewrath|TheWrath]] || general cleanup & added some  more resources
 +
|-
 +
| [[UbuntuHelp:Firestarter|Firestarter]] || Rocket2DMn || firewall pages re-org
 +
|-
 +
| [[UbuntuHelp:Iptables|Iptables]] || bodhi.zazen & Rocket2DMn & cprofitt || firewall pages re-org
 +
|-
 +
| [[UbuntuHelp:KVM|KVM]] & subpages/related || bodhi.zazen & Rocket2DMn || KVM documentation re-org.  Split off documentation for front-ends (virsh, virt-manager)
 +
|-
 +
|[[UbuntuHelp:Installation/FromAnotherDistro|Installation/FromAnotherDistro]] || duanedesign || Content/Style Cleanup
 +
|-
 +
| [[UbuntuHelp:Glossary|Glossary]] || Silver_Fox || Add in definitions for commented out terms (still loads left) .  Also find some further reading links for terms.
 +
|-
 +
|[[UbuntuWiki:Launchpad|| Launchpad]] [[UbuntuWiki:LaunchpadHowTo|| Launchpad How To ]] || duanedesign / Launchpad FG || Content/Style Cleanup Needs Expansion Combine Pages
 +
|-
 +
| [[UbuntuHelp:Enlightenment||Enlightenment ]] || duanedesign || Needs Expansion
 +
|-
 +
| [[UbuntuHelp:SoftwareCenter]] || ddecator || Need a support page for Ubuntu Software Center - write from scratch w/ screenshots! Integrate with [[UbuntuHelp:InstallingSoftware|InstallingSoftware]]. See [[UbuntuWiki:SoftwareCenter]]
 +
|}
 +
=== Finished ===
 +
Pages that have been completed (or mostly completed).  Please only include pages that required ''more than trivial work'' to complete.  Also please list them in chronological order.  Anybody can add to these pages now:
 +
{|border="1" cellspacing="0"
 +
| Page || Editor || Date Finished (Year-Month-Day)
 +
|-
 +
| [[UbuntuHelp:DriveImaging]] || [[UbuntuWiki:starcraft.man|starcraft.man]] || 2009-09-27
 +
|-
 +
| [[UbuntuHelp:SwapFaq]] || [[UbuntuWiki:Nigel_NB|Nigel_NB]] || 2009-10-22
 +
|-
 +
| [[UbuntuHelp:Grub2]] || [[UbuntuWiki:drs305|drs305]] || 2009-10-22
 +
|-
 +
|[[UbuntuWiki:Pastebin|| Pastebin]] || [[UbuntuWiki:duanedesign||duanedesign]] || 2009-10-30
 +
|-
 +
| [[UbuntuHelp:ManageDiscImages]] || [[UbuntuWiki:starcraft.man|starcraft.man]] || 2009-12-28 (real date, ages ago)  
 +
|-
 +
| [[UbuntuHelp:GnomeBaker]] || [[UbuntuWiki:starcraft.man|starcraft.man]] || 2009-12-31
 +
|}
 +
=== Launchpad Bugs ===
 +
This area is for those contributing to and fixing documentation related bugs on Launchpad. Most are for the [https://bugs.launchpad.net/ubuntu/+source/ubuntu-docs ubuntu-docs] package, but any kind of documentation is acceptable.  Interested users should see [[UbuntuWiki:DocumentationTeam/SystemDocumentation]].
 +
{|border="1" cellspacing="0"
 +
| Launchpad Bug || Assignee/Contributor || Comments
 +
|-
 +
| [https://bugs.launchpad.net/ubuntu/+source/ubuntu-docs/+bug/437446 437446] || [[UbuntuWiki:drs305|drs305]]||Proposed official documentation submitted.
 +
|}
 
== Things To Remember ==
 
== Things To Remember ==
Our Main Job on the wiki is to help improve it, not duplicate efforts
+
* use [[UbuntuHelp:HelpOnEditing|HelpOnEditing]]
*This means making sure if there are already articles for the things we want, '''improve''' and '''link''' to those instead.
+
* [[UbuntuWiki:DocumentationTeam/Wiki/Tasks]] for pages that need some help
*Make sure you do thorough searches to see if the subject matter already exists.
+
* [[UbuntuHelp:WikiGuide|WikiGuide]] and all of its subpages.
*Never cluttering pages, keep things simple, and provide links.
+
* do not duplicate effort - link to other pages!
*Keeping as many links internal as possible.
+
* minimize CLI
*If possible, link to the work of our wonderful screencasting team: http://doc.ubuntu.com/screencasts/
+
* documentation reflects latest and supported releases of Ubuntu
Unneccessarily complicating things.
+
* use screenshots, see [[UbuntuHelp:WikiGuide/Screenshots|WikiGuide/Screenshots]] for guidelines
*This means staying away from the cli as much as possible.
+
* don't use jargon and technical terms, link to and use terms from the [[UbuntuHelp:Glossary|Glossary]]
*The more new things that are introduced, the more confusion.
+
== Other Resources ==
*Making sure you look over everything you do several times, to simplify.
+
From [[UbuntuHelp:Beginners/Team/FocusGroups/Wiki|Beginners/Team/FocusGroups/Wiki]]
https://help.ubuntu.com/community/Beginners/Development?action=AttachFile&do=get&target=Documentation-Basics.jpg
+
=== Links ===
== Screenshots ==
+
* [[UbuntuHelp:WikiGuide|WikiGuide]]
We want '''PLENTY''' of clear and illustrative screenshots for all gui operations.
+
* HelpOnFormatting
*Make sure they are cropped properly - you can take a screenshot of the window in focus with <Alt>Print Screen.
+
* HelpOnEditing - here are some of the most useful:
*Hopefully use the Human theme/Default Plastik/Glass combo for KDE.
+
* HelpOnHeadlines
*It would even be nice if we could follow the screencasting guidelines, of using virtual machines, clean boot, to make menus and such identical to default and clean install.
+
* HelpOnLinking
"The reason for using a virtual machine rather than the current desktop is to ensure the screenshots are showing what a user would see. Most developers (or even experienced users) have additional software installed (such as the video recording application), have customised their desktop, or are running a version of Ubuntu (such as the current development version) which users might be less likely to use.
+
* HelpOnLists
It also allows for a "gold" build to be kept in a disk image which can be re-used after the screenshots are. This means each set of screenshots starts from the same basic starting point of a fresh (new) installation of Ubuntu. If screenshots and howtos are made which assume levels of knowledge or that certain software is already installed then it's possible users will get lost or give up when they see that the screenshots doesn't match what they see." - Modified Excerpt from screencasting team article.
+
* HelpOnTables
=== Guidelines for Screenshots ===
+
* IconsPage
Screen shots should be done with a '''default install''' ~ This means '''default background, default menus, default icons, etc'''.
+
* HelpOnSmileys
This is best accomplished with a '''virtual machine''' with no customization. Options include qemu, vmware, and virtual box.
+
* Documentation Team Links for members interested in reviewing system documentation
== Wiki Guidelines ==
+
* Ubuntu:DocumentationTeam/Repository
To help new users feel at ease we do not want to over-burden them with inaccessible ''jargon''. The glossary, explained below, will take care of some of the problems associated with new terms, but as a team we need to ensure that we keep our language and explanations as lucid as possible. We want clear-cut phrases, avoiding ''high densities'' of technical terms.
+
* [http://doc.bazaar-vcs.org/latest/en/mini-tutorial/index.html Bazaar in five minutes] - a nice quick start quide
=== References ===
+
* Ubuntu:DocumentationTeam/ReviewingDocumentation
Please look at these pages :
+
* Ubuntu:DocumentationTeam/TechReview
[http://doc.ubuntu.com/styleguide/styleguide.html Ubuntu Documentation Style Guide]
+
* Ubuntu:DocumentationTeam/TechReviewExample - example of review process, see Ubuntu:DocumentationTeam/Repository for patching and submission process
WikiGuide
+
=== Wiki Tips ===
HelpOnEditing
+
* Where to submit a page for deletion: [[UbuntuHelp:WikiToDo|WikiToDo]]
=== Glossary ===
+
* Redirecting Pages: [[UbuntuHelp:HelpOnProcessingInstructions|HelpOnProcessingInstructions]]
We have started a basic terms glossary: [[UbuntuWiki:Beginners/Guide/Terms|Terms]].
+
* [http://packages.ubuntu.com/hardy/editmoin editing the wiki with a standard text editor]
In order that we can start to build up a bank of concise and useful definitions, it is recommended that as you add articles to our section of this wiki, you gloss key terms and link to them as you add them to your articles. This will ensure that we have the inter-linking in place that is necessary to make the process of finding and ''understanding'' information as intuitive as possible.
+
----
 +
[[category:CategoryDevelopment]]
  
 
[[category:UbuntuHelp]]
 
[[category:UbuntuHelp]]

2010年5月19日 (三) 21:41的最新版本


This page is used by the Beginners Team Wiki Focus Group to communicate ideas and use for wiki editing organization.

Documentation Reservation Area

Here is where you can "lay claim" to wiki pages that you want to update or rewrite. Claimed pages will not be touched by other BT members unless the owner gives permission (say, in IRC).

Still Available

Pages that have been marked for updating:

Page Interested Users Comments/Ideas
EasyWirelessToWiredConnectionSharing lukjad007 Needs cleanup
Wine Needs some cleanup, reorganization
Any and all pages relating to bluetooth Matthew (mdke), the doc team lead, has requested that we look at bluetooth pages if anybody has experience.
Kubuntu
InitScriptList Rocket2DMn
EdubuntuFAQ cleanup, nominated cprofitt based on experience
Edubuntu Recipes - Network Install needs expansion
NetworkManagementTools expansion, cleanup. May need to be hooked up with other existing documentation.
BridgingNetworkInterfaces, NetworkConnectionBridge, NetworkMonitoringBridge duplicate documentation, cleanup. Perhaps link to a central bridging page from all over the docs.
BluetoothSetup Very outdated, needs to be updated, update bug report accordingly: https://bugs.launchpad.net/bugs/304924

Claimed

Pages that have been claimed by a user:

Page Editor Comments
RecoveringUbuntuAfterInstallingWindows lukjad007 cleanup
Ksplice lukjad007 Creation, would like links to documentation.
DesktopEffects Rocket2DMn general re-org for DE pages
UbuntuHelp:GnuPrivacyGuardHowto TheWrath general cleanup & added some more resources
Firestarter Rocket2DMn firewall pages re-org
Iptables bodhi.zazen & Rocket2DMn & cprofitt firewall pages re-org
KVM & subpages/related bodhi.zazen & Rocket2DMn KVM documentation re-org. Split off documentation for front-ends (virsh, virt-manager)
Installation/FromAnotherDistro duanedesign Content/Style Cleanup
Glossary Silver_Fox Add in definitions for commented out terms (still loads left) . Also find some further reading links for terms.
[[UbuntuWiki:Launchpad Launchpad]] [[UbuntuWiki:LaunchpadHowTo Launchpad How To ]] duanedesign / Launchpad FG Content/Style Cleanup Needs Expansion Combine Pages
[[UbuntuHelp:Enlightenment Enlightenment ]] duanedesign Needs Expansion
UbuntuHelp:SoftwareCenter ddecator Need a support page for Ubuntu Software Center - write from scratch w/ screenshots! Integrate with InstallingSoftware. See UbuntuWiki:SoftwareCenter

Finished

Pages that have been completed (or mostly completed). Please only include pages that required more than trivial work to complete. Also please list them in chronological order. Anybody can add to these pages now:

Page Editor Date Finished (Year-Month-Day)
UbuntuHelp:DriveImaging starcraft.man 2009-09-27
UbuntuHelp:SwapFaq Nigel_NB 2009-10-22
UbuntuHelp:Grub2 drs305 2009-10-22
[[UbuntuWiki:Pastebin Pastebin]] [[UbuntuWiki:duanedesign duanedesign]] 2009-10-30
UbuntuHelp:ManageDiscImages starcraft.man 2009-12-28 (real date, ages ago)
UbuntuHelp:GnomeBaker starcraft.man 2009-12-31

Launchpad Bugs

This area is for those contributing to and fixing documentation related bugs on Launchpad. Most are for the ubuntu-docs package, but any kind of documentation is acceptable. Interested users should see UbuntuWiki:DocumentationTeam/SystemDocumentation.

Launchpad Bug Assignee/Contributor Comments
437446 drs305 Proposed official documentation submitted.

Things To Remember

Other Resources

From Beginners/Team/FocusGroups/Wiki

Links

  • WikiGuide
  • HelpOnFormatting
  • HelpOnEditing - here are some of the most useful:
  • HelpOnHeadlines
  • HelpOnLinking
  • HelpOnLists
  • HelpOnTables
  • IconsPage
  • HelpOnSmileys
  • Documentation Team Links for members interested in reviewing system documentation
  • Ubuntu:DocumentationTeam/Repository
  • Bazaar in five minutes - a nice quick start quide
  • Ubuntu:DocumentationTeam/ReviewingDocumentation
  • Ubuntu:DocumentationTeam/TechReview
  • Ubuntu:DocumentationTeam/TechReviewExample - example of review process, see Ubuntu:DocumentationTeam/Repository for patching and submission process

Wiki Tips