个人工具

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

来自Ubuntu中文

跳转至: 导航, 搜索
第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
+
[[UbuntuHelp:SolvingGnomeThumbnailsTrouble|SolvingGnomeThumbnailsTrouble]]|#title Beginners Team Development Page
== Tasks ==
+
'''This page will soon be deprecated and moved to the team wiki.'''
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.
+
This page is used by the Beginners Team to communicate ideas and use for wiki editing organization.
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.
+
== Documentation Reservation Area ==
2. CLI should be minimised, tucked.
+
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).
3. Eliminate all these pages, by either moving the information into the guide or regular wiki, or eliminating it.
+
The whole team will be working on [[Beginners/FAQ]] which is where many of the following ideas come from.
 
+
=== Still Available ===
Beginners/Guide/Dapper
+
Pages that have been marked for updating (also see [[category:CategoryCleanup,]] though it is now deprecated in favor of the [[Tag]] system):
Beginners/Guide/Edgy
+
{|border="1" cellspacing="0"
Beginners/Guide/Feisty
+
| Page || Interested Users || Comments
Beginners/Guide/Feisty/Gaim
+
|-
Beginners/Guide/Feisty/Multimedia
+
| insert page link here || if you are interested but do not want to claim yet, place your name here || ideas on what needs to be done
4. Things to Add
+
|-
 
+
|SolvingGnomeThumbnailsTrouble|| || Update for Hardy change focus from totem to generic issues/thummbnail cache size, reformat for wiki
Desktop Guide
+
|-
*Should probably include how to browse gnome-look/kde-look, save something, and choose it.
+
| [[Wine]] || || cleanup
*Themes -- Do not include Beryl in this, compiz is default.
+
|-
*Engines?
+
| [[Fluxbox]] || || needs cleanup and expansion
*Sounds
+
|-
*Splashes (DE, and possibly usplash)
+
| [[QuickTips]] ||  || cleanup/expand or otherwise figure out what to do with it  
*KDE and XFCE
+
|-
*Carefully chosen list of professional sites to pick customisations from.
+
| [[VirtualMachines]] || Het Irv || cleanup, expansion
Installation of programs, most importantly from Add/Remove Programs. *TODO: Check if any guide exists for this.
+
|}
*If possible use programs as an abstraction of packages.
+
=== Claimed ===
 +
Pages that have been claimed by a user:
 +
{|border="1" cellspacing="0"
 +
| Page || Editor || Comments
 +
|-
 +
| insert page link here ||  editor's name here || ideas on what needs to be done
 +
|-
 +
| [[Sudoers]] || tinivole || Fix errors, cleanse outdated text, beautify it for new users.  
 +
|-
 +
| [[WindowsDualBoot]] || Old_Soldier || cleanup
 +
|-
 +
| [[AppleRemoteDesktop]] || indigo196 || needs revision and removal of inaccuracies
 +
|}
 +
=== Finished ===
 +
Pages that have been completed (or mostly completed).  Please only include pages that required ''heavy 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)  
 +
|-
 +
| insert page link here || editor's name here || completion date here
 +
|}
 +
All completed pages from the Summer of Documentation have been moved to the team [[UbuntuWiki:]] Ubuntu:BeginnersTeam/FocusGroups/Wiki/SoD2008
 
== Things To Remember ==
 
== Things To Remember ==
Our Main Job on the wiki is to help improve it, not duplicate efforts
+
* use [[HelpOnEditing]]
*This means making sure if there are already articles for the things we want, '''improve''' and '''link''' to those instead.
+
* [[WikiToDo]] for pages that need some help
*Make sure you do thorough searches to see if the subject matter already exists.
+
* don't forget [[category:Category''Cleanup'']] and [[category:Category''Needs''Expansion]]
*Never cluttering pages, keep things simple, and provide links.
+
* see help.ubuntu.com/community/<[[category:Category''Type''>]]
*Keeping as many links internal as possible.
+
* [[WikiGuide]] and all of its subpages.
*If possible, link to the work of our wonderful screencasting team: http://doc.ubuntu.com/screencasts/
+
* do not duplicate effort - link to other pages!
Unneccessarily complicating things.
+
* minimize CLI
*This means staying away from the cli as much as possible.
+
* documentation reflects latest and supported releases of Ubuntu
*The more new things that are introduced, the more confusion.
+
* use screenshots, see [[WikiGuide/Screenshots]] for guidelines
*Making sure you look over everything you do several times, to simplify.
+
* don't use jargon and technical terms, link to and use terms from the [[Glossary|Glossary]]
https://help.ubuntu.com/community/Beginners/Development?action=AttachFile&do=get&target=Documentation-Basics.jpg
+
== Other Resources ==
== Screenshots ==
+
From [[Beginners/Team/FocusGroups/Wiki]]
We want '''PLENTY''' of clear and illustrative screenshots for all gui operations.
+
=== Links ===
*Make sure they are cropped properly - you can take a screenshot of the window in focus with <Alt>Print Screen.
+
* [[UbuntuHelp:WikiGuide|WikiGuide]]
*Hopefully use the Human theme/Default Plastik/Glass combo for KDE.
+
* HelpOnFormatting
*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.
+
* HelpOnEditing - here are some of the most useful:
"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.
+
* HelpOnHeadlines
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.
+
* HelpOnLinking
=== Guidelines for Screenshots ===
+
* HelpOnLists
Screen shots should be done with a '''default install''' ~ This means '''default background, default menus, default icons, etc'''.
+
* HelpOnTables
This is best accomplished with a '''virtual machine''' with no customization. Options include qemu, vmware, and virtual box.
+
* IconsPage
== Wiki Guidelines ==
+
* HelpOnSmileys
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.
+
* Documentation Team Links for members interested in reviewing system documentation
=== References ===
+
* Ubuntu:DocumentationTeam/Repository
Please look at these pages :
+
* [[http://doc.bazaar-vcs.org/latest/en/mini-tutorial/index.html|Bazaar in five minutes]] - a nice quick start quide
[http://doc.ubuntu.com/styleguide/styleguide.html Ubuntu Documentation Style Guide]
+
* Ubuntu:DocumentationTeam/ReviewingDocumentation
[[UbuntuHelp:WikiGuide|WikiGuide]]
+
* Ubuntu:DocumentationTeam/TechReview
HelpOnEditing
+
* Ubuntu:DocumentationTeam/TechReviewExample - example of review process, see Ubuntu:DocumentationTeam/Repository for patching and submission process
=== Glossary ===
+
=== Wiki Tips ===
Please use this [[UbuntuWiki:Glossary|Glossary]].
+
* Where to submit a page for deletion: [[UbuntuHelp:WikiToDo|WikiToDo]]
 +
* Redirecting Pages: [[HelpOnProcessingInstructions]]
 +
* [[http://packages.ubuntu.com/hardy/editmoin|editing the wiki with a standard text editor]]
 +
----
 +
[[category:CategoryDevelopment]]
  
 
[[category:UbuntuHelp]]
 
[[category:UbuntuHelp]]

2008年10月19日 (日) 04:21的版本


SolvingGnomeThumbnailsTrouble|#title Beginners Team Development Page This page will soon be deprecated and moved to the team wiki. This page is used by the Beginners Team 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). The whole team will be working on Beginners/FAQ which is where many of the following ideas come from.

Still Available

Pages that have been marked for updating (also see though it is now deprecated in favor of the Tag system):

Page Interested Users Comments
insert page link here if you are interested but do not want to claim yet, place your name here ideas on what needs to be done
SolvingGnomeThumbnailsTrouble Update for Hardy change focus from totem to generic issues/thummbnail cache size, reformat for wiki
Wine cleanup
Fluxbox needs cleanup and expansion
QuickTips cleanup/expand or otherwise figure out what to do with it
VirtualMachines Het Irv cleanup, expansion

Claimed

Pages that have been claimed by a user:

Page Editor Comments
insert page link here editor's name here ideas on what needs to be done
Sudoers tinivole Fix errors, cleanse outdated text, beautify it for new users.
WindowsDualBoot Old_Soldier cleanup
AppleRemoteDesktop indigo196 needs revision and removal of inaccuracies

Finished

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

Page Editor Date Finished (Year-Month-Day)
insert page link here editor's name here completion date here

All completed pages from the Summer of Documentation have been moved to the team [[UbuntuWiki:]] Ubuntu:BeginnersTeam/FocusGroups/Wiki/SoD2008

Things To Remember

  • use HelpOnEditing
  • WikiToDo for pages that need some help
  • don't forget and
  • see help.ubuntu.com/community/<[[category:CategoryType>]]
  • WikiGuide and all of its subpages.
  • do not duplicate effort - link to other pages!
  • minimize CLI
  • documentation reflects latest and supported releases of Ubuntu
  • use screenshots, see WikiGuide/Screenshots for guidelines
  • don't use jargon and technical terms, link to and use terms from the Glossary

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
  • [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