workspace/systemsettings/LAYOUT.html

   1
   2 <h1>KDE System Settings</h1>
   3
   4 <p>
   5 This document describes how the System Settings is layed out.
   6
   7 <p>
   8 This document was inspired partially by the TODO file located at kdebase/kcontrol/TODO.  Most of the changed are the exact same and were planned to be done for KDE4.  This document is simply a little bit more fleshed out version.  I recomend checking out that document if you havn't already.
   9
  10 <p>
  11 The reason for this document is:
  12 <p>
  13 1) To categorize the settings together in a user friendly manor.<br>
  14 2) To explain why a setting is where it is and to determine where new settings should go.<br>
  15 3) Because of #2 stop the constant reorganization of KControl at every release confusing users and developers because there isn't a documented location for where thing go with explanations of why.
  16 <p>
  17 The System Settings Center is divided into four sections.
  18 <ul>
  19 <li><a href="#personal">Personal</a></li>
  20 <li><a href="#hardware">Hardware</a></li>
  21 <li><a href="#system">System</a></li>
  22 <li><a href="#other">Other</a></li>
  23 </ul>
  24
  25 Within KDE there are over 50 kcm modules designed for the Control Center and many more for konquror and other applications.  With so many modules there is no way for a users to find what they are looking for by scanning.  To solve this there are three levels, the last one isn't normally visable to the user and groups very similar items.
  26 <p>
  27 Modules in the System Settings should configure things not do things.  Some examples include the theme manager.  It sets/saves themes.  Although it configures settings it is a seperate application because it does actions rather than just setting/getting values.  Items that
  28 <p>
  29 Modules that exists within multiple applications configuration menu such as spell check and cddb should not be in the menu.
  30
  31 <hr>
  32 <a name="personal"><h1>Personal</h1></a>
  33 Personal is made up of two parts.  The simplest differece between the two are theme settings will be shared amung friends while users settings wont be.
  34 <ul>
  35 <li><a href="#personal_theme">Theme Goodies</a></li>
  36 <li><a href="#personal_user">User Settings</a></li>
  37 </ul>
  38
  39 <h3><a name="personal_theme">Theme Goodies</a></h3> which can be changed without affecting productivity and often doesn't directly apply to a specific user, but to a user base (Theme of the month crowd).
  40
  41 These deal with how applications are presented to users and how users interact with them. These don't deal with anything that isn't directly seen/heard or interacted with.
  42 <p>
  43 Every setting in this category must be able to be locked for example in an government enviornment where they determine exactly how a desktop is to look for every user.  It may look ugly, but users should still be able to acomplish tasks no matter what these settings are set to.
  44 <p>
  45 A separate application (Theme Manager) can set the items in this category on mass to give an overall theme for the user.  This application can also save the current settings.
  46
  47 <h3><a name="personal_user">User Settings</a></h3>
  48 Such as that apply to this computer such as language and personal choice for default web browser.  These settings determine how a user interacts with a computer, but is personal to that user and typically isn't shared like a theme or icons set is.
  49
  50 <h2>Appearance</h2>
  51 The Appearance deals with the look of the applications and desktop.  These settings typically will be settings that can be replaced by alternatives created outside of KDE.  These settings will most likely be also set/used by other Unix desktop enviornments so that all the applications can integration together (and look consistant to the user).  It contains the following items:<br>
  52 Colors, Fonts, Icons, Style, Window Decorations
  53
  54 <h2>Desktop</h2>
  55 These items discus how the desktop behaves.  How the windows interact with each other, the very bottom of the screen (desktop), the very top (screensaver), and loading of the desktop.  These are all separate setting from KDE (or Gnome) applications and the applications shouldn't need to access them or know about them.
  56 It contains the following items:<br>
  57 Background, Screensaver, Behavior, Window Behavior, Window-Specific Settings, Login Screen
  58 <p>
  59 Panel.
  60 These settings all deal with when users perform actions dealing with or originating from the panel.  It contains the following items:<br>
  61 Panels, Taskbar, Launch Feedback, Multiple Desktops
  62
  63 <h2>KDE Components</h2>
  64 Specific actuall KDE components which users will probably never actually touch.
  65
  66 <h2>Accessibility</h2>
  67  - International
  68  - KHotKeys etc
  69
  70 <h2>Security</h2>
  71 -kdewallet
  72
  73 <h2>Sound</h2>
  74 Sounds, flashes, logs or other events that happen when KDE applications.
  75 System Bell
  76 System Notifications
  77
  78 <h2>User Account</h2>
  79 - Password changer, paths, Default Applications, Session Manager
  80
  81 <hr>
  82 <a name="hardware"><h1>Hardware</h1></a>
  83 Hardware deals with physical hardware configuration.  Configuration is not only for the hardware, but the required supporting systems that use the hardware.
  84
  85 <h2>Network</h2>
  86 File Sharing
  87 Local Network Browsing
  88 Preferences / Proxy
  89 Wireless
  90 Firewall
  91 <h2>Display</h2>
  92 It contains the following items:<br>
  93 Size & Orientation, Gamma
  94 <h2>Power</h2>
  95 Display power control
  96 laptop battery, cpu temp etc
  97 <h2>Keyboard & Mouse</h2>
  98 Keyboard, Keyboard Layout, Keyboard Shortcuts, Mouse, KHotKeys
  99 <h2>Printer</h2>
 100 <h2>Joystick</h2>
 101 <h2>Audio</h2>
 102 Mixer, SoundSystem (arts)
 103
 104 <hr>
 105 <a name="system"><h1>System</h1></a>
 106 System deals with settings relating to this computer.
 107
 108 <h2>Date & Time</h2>
 109 Date, Time, Time zone
 110
 111 <h2>Fonts</h2>
 112
 113 <h2>Book Disk</h2>
 114 Lilo, Grub
 115
 116 <h2>Packages</h2>
 117 System update / rpm manager etc
 118
 119 <h2>Login Manager</h2>
 120 Login Manger
 121
 122 <hr>
 123 <a name="other"><h1>Other</h1></a>
 124 A default KDE install should contain nothing here.  If there is something here than this document has failed and needs to be revised.  Until that can happen its temporary home is here.  A user should never see this catagory.
 125