个人工具

UbuntuHelp:Beginners/Development/zh

来自Ubuntu中文

Sue37讨论 | 贡献2008年3月31日 (一) 14:41的版本

跳转至: 导航, 搜索


此页用于初学者开发团队交流想法。

任务

此文档应该始终反应最新的版本,如果有任何版本存在特殊的不同点,这些不同点应该并且仅应该被安放于共同的类别下其自己的页面与连接中。  因此,举例来说:如果Dapper版本的编解码器(codec)安装方法是不同的,则它应该在Media/Dapper下,或Media/Video/Dapper下如果Video恰巧是一个子类。 1. 常见问题(FAQ)应该针对问题而不应该是所有的任务。所列出的条目应链接至其自己的页面中,并且在向导(guide)中加以连接,或放入某个硬件故障检修器(troubleshooter)中。2. 命令行界面(CLI)应尽可精简。3.通过移动所有信息到向导(guide)或常用wiki中以去除以下所有页面,或者去除他们。

Beginners/Guide/Dapper Beginners/Guide/Edgy Beginners/Guide/Feisty Beginners/Guide/Feisty/Gaim Beginners/Guide/Feisty/Multimedia 4. Things to Add

Desktop Guide

  • 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.
  • Engines?
  • Sounds
  • Splashes (DE, and possibly usplash)
  • KDE and XFCE
  • 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.

  • If possible use programs as an abstraction of packages.

Things To Remember

Our Main Job on the wiki is to help improve it, not duplicate efforts

  • This means making sure if there are already articles for the things we want, improve and link to those instead.
  • Make sure you do thorough searches to see if the subject matter already exists.
  • Never cluttering pages, keep things simple, and provide links.
  • Keeping as many links internal as possible.
  • If possible, link to the work of our wonderful screencasting team: http://doc.ubuntu.com/screencasts/

Unneccessarily complicating things.

  • This means staying away from the cli as much as possible.
  • The more new things that are introduced, the more confusion.
  • Making sure you look over everything you do several times, to simplify.

Development?action=AttachFile&do=get&target=Documentation-Basics.jpg

Screenshots

We want PLENTY of clear and illustrative screenshots for all gui operations.

  • Make sure they are cropped properly - you can take a screenshot of the window in focus with <Alt>Print Screen.
  • Hopefully use the Human theme/Default Plastik/Glass combo for KDE.
  • 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.

"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. 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.

Guidelines for Screenshots

Screen shots should be done with a default install ~ This means default background, default menus, default icons, etc. This is best accomplished with a virtual machine with no customization. Options include qemu, vmware, and virtual box.

Wiki Guidelines

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.

References

Please look at these pages : Ubuntu Documentation Style Guide WikiGuide HelpOnEditing

Glossary

We have started a basic terms glossary: Terms. 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.