AboutThisComputer

Differences between revisions 1 and 20 (spanning 19 versions)
Revision 1 as of 2007-10-22 18:27:49
Size: 2707
Editor: wing-commander
Comment:
Revision 20 as of 2007-11-22 14:07:51
Size: 4970
Editor: 14
Comment: Hopefully address Keybuk's last concern
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
## page was renamed from HardyAboutUbuntu
Line 5: Line 6:
 * '''Launchpad Entry''': UbuntuSpec:hardy-about-ubuntu
 * '''Packages affected''': about-ubuntu
 * '''Launchpad Entry''': UbuntuSpec:about-this-computer
 * '''Packages affected''':
Line 10: Line 11:
Redesign the current "About Ubuntu" menu option such that it contains useful information such as the Ubuntu derivative name, version number, basic information about the system. This should be visually attractive, and could be an ideal place for easter eggs. About This Computer should show useful information about your computer, its hardware, installed operating system and desktop environment(s).
Line 14: Line 15:
This section should include a paragraph describing the end-user impact of this change. It is meant to be included in the release notes of the first release in which it is implemented. (Not all of these will actually be included in the release notes, at the release manager's discretion; but writing them is a useful exercise.)

It is mandatory.
New with this version of Ubuntu, the "About Ubuntu" and "About Gnome" dialogs have been replaced with a more generic "About This Computer" dialog that shows basic information about your machine along with software versions for Gnome or KDE.
Line 20: Line 19:
This should cover the _why_: why is this change being proposed, what justifies it, where we see this justified. The current "About Ubuntu" and "About GNOME" items are not helpful, elegant, or (least importantly) consistent with what people expect from other operating systems. And merely having two menu items gives the impression that Ubuntu is fragmented and disorganized.
Line 24: Line 23:
== Assumptions ==  * Third-party software often has minimum system requirements, most often involving the operating system version, processor speed, and amount of memory available. Often they also mention a particular amount of disk space, but this is much less important (because people almost always have enough). Occasionally they have other requirements (such as a particular graphics card).

 * Tech support for Ubuntu often requires knowing what version of Ubuntu someone is using. People often have trouble scanning text on a computer screen, so embedding the Ubuntu version in lots of other text can be frustrating.

 * Tech support for Linux in general often requires knowing what Linux kernel version someone is using, and sometimes requires knowing what version of Gnome or KDE they are using.
Line 28: Line 31:
You can have subsections that better describe specific parts of the issue.  * [http://guidebookgallery.org/screenshots/aboutgui Comparisons from other graphical environments]

About This Computer (about-window) is a Python script that checks the existence of the environment variable {{{KDE_FULL_SESSION}}}. If it is present, the script will import a Python module that pulls in PyQT and draws the dialog using the QT toolkit. Otherwise, the Python module that utilities PyGTK and Glade will be used.

We will query the following information about the system:
 * CPU type and speed, using /proc/cpuinfo
 * RAM, using /proc/meminfo, or "free"
 * Hard disk size (use the disk / hangs off), using hal via dbus
 * Graphics card, also using hal via dbus
 * Network card, also using hal via dbus
 * Version of Ubuntu, using lsb-release.
 * Version of desktop environment -- this is a can of worms, but we are limiting ourselves to querying the version of GNOME, KDE or XFCE. If we find none of them, then do not display anything.
 * Version of the Linux kernel, using "uname -r"
Line 32: Line 47:
This section should describe a plan of action (the "how") to implement the changes discussed. Could include subsections like: The dialog box will be designed to look identical if using PyQT or PyGTK, with the only difference being the toolkit used. The icon of the window will be a visually attractive computer icon, with this also being shown prominently on the left hand of the window.
Line 34: Line 49:
=== UI Changes === The right hand side of the window will be made up of two sections, with the first being:
Line 36: Line 51:
Should cover changes required to the UI, or specific UI that is required to implement this {{{
CPU: <CPU type> <CPU speed>
Memory: <RAM information>
Hard Disk: <size of the disk / is on>
Graphics Card: <Graphics Card information>
Network Card: <Network Card information>
}}}
Line 38: Line 59:
=== Code Changes === And the second displaying:
Line 40: Line 61:
Code changes should include an overview of what needs to change, and in some cases even the specific details. {{{
<icon grabbed from the icon theme "start-here"> Ubuntu <Ubuntu version>
(Only displayed if gnome-session exists) <gnome icon> Gnome <Gnome version>
(Only displayed if kded exists) <KDE icon> KDE <KDE version>
(Only displayed if xfce-session exists) <XFCE icon> XCFE <XCFE version>
<tux icon> Linux <kernel version>
}}}
Line 42: Line 69:
=== Migration === A Close button on the bottom right of the window.
Line 44: Line 71:
Include:
 * data migration, if any
 * redirects from old URLs to new ones, if any
 * how users will be pointed to the new way of doing things, if necessary.
All text should be able to be drag and dropped as one large block into IRC, a bug report or a forum post.

== Migration ==

The current information shown in About Ubuntu, and to a lesser extent in About GNOME will be assimilated into the documentation that the Help and Support menu item displays.

=== GNOME ===

An "About This Computer" item on the System menu will replace the "About Ubuntu", and "About Gnome" menu items.

=== KDE ===

An "About This Computer" item will be added to the standard KDE application Help menu which will launch the QT version of the app.

=== XFCE ===

An "About This Computer" item will be added to the System menu.
Line 51: Line 91:
It's important that we are able to test new features, and demonstrate them to users. Use this section to describe a short plan that anybody can follow that demonstrates the feature is working. This can then be used during CD testing, and to show off after release. Check that for common hardware (everything testers can get their hands on and more), that About This Computer correctly detects the Ubuntu version, the processor and the RAM size (with appropriate and correct scaling/rounding), along with the desktop environments that the user has installed.
Line 53: Line 93:
This need not be added or completed until the specification is nearing beta. == See Also ==
Line 55: Line 95:
== Outstanding Issues ==

This should highlight any issues that should be addressed in further specifications, and not problems with the specification itself; since any specification with problems cannot be approved.

== BoF agenda and discussion ==

Use this section to take notes during the BoF; if you keep it in the approved spec, use it for summarising what was discussed and note any options that were rejected.

See:

Please check the status of this specification in Launchpad before editing it. If it is Approved, contact the Assignee or another knowledgeable person before making changes.

Summary

About This Computer should show useful information about your computer, its hardware, installed operating system and desktop environment(s).

Release Note

New with this version of Ubuntu, the "About Ubuntu" and "About Gnome" dialogs have been replaced with a more generic "About This Computer" dialog that shows basic information about your machine along with software versions for Gnome or KDE.

Rationale

The current "About Ubuntu" and "About GNOME" items are not helpful, elegant, or (least importantly) consistent with what people expect from other operating systems. And merely having two menu items gives the impression that Ubuntu is fragmented and disorganized.

Use Cases

  • Third-party software often has minimum system requirements, most often involving the operating system version, processor speed, and amount of memory available. Often they also mention a particular amount of disk space, but this is much less important (because people almost always have enough). Occasionally they have other requirements (such as a particular graphics card).
  • Tech support for Ubuntu often requires knowing what version of Ubuntu someone is using. People often have trouble scanning text on a computer screen, so embedding the Ubuntu version in lots of other text can be frustrating.
  • Tech support for Linux in general often requires knowing what Linux kernel version someone is using, and sometimes requires knowing what version of Gnome or KDE they are using.

Design

About This Computer (about-window) is a Python script that checks the existence of the environment variable KDE_FULL_SESSION. If it is present, the script will import a Python module that pulls in PyQT and draws the dialog using the QT toolkit. Otherwise, the Python module that utilities PyGTK and Glade will be used.

We will query the following information about the system:

  • CPU type and speed, using /proc/cpuinfo
  • RAM, using /proc/meminfo, or "free"
  • Hard disk size (use the disk / hangs off), using hal via dbus
  • Graphics card, also using hal via dbus
  • Network card, also using hal via dbus
  • Version of Ubuntu, using lsb-release.
  • Version of desktop environment -- this is a can of worms, but we are limiting ourselves to querying the version of GNOME, KDE or XFCE. If we find none of them, then do not display anything.
  • Version of the Linux kernel, using "uname -r"

Implementation

The dialog box will be designed to look identical if using PyQT or PyGTK, with the only difference being the toolkit used. The icon of the window will be a visually attractive computer icon, with this also being shown prominently on the left hand of the window.

The right hand side of the window will be made up of two sections, with the first being:

CPU: <CPU type> <CPU speed>
Memory: <RAM information>
Hard Disk: <size of the disk / is on>
Graphics Card: <Graphics Card information>
Network Card: <Network Card information>

And the second displaying:

<icon grabbed from the icon theme "start-here"> Ubuntu <Ubuntu version>
(Only displayed if gnome-session exists) <gnome icon> Gnome <Gnome version>
(Only displayed if kded exists) <KDE icon> KDE <KDE version>
(Only displayed if xfce-session exists) <XFCE icon> XCFE <XCFE version>
<tux icon> Linux <kernel version>

A Close button on the bottom right of the window.

All text should be able to be drag and dropped as one large block into IRC, a bug report or a forum post.

Migration

The current information shown in About Ubuntu, and to a lesser extent in About GNOME will be assimilated into the documentation that the Help and Support menu item displays.

GNOME

An "About This Computer" item on the System menu will replace the "About Ubuntu", and "About Gnome" menu items.

KDE

An "About This Computer" item will be added to the standard KDE application Help menu which will launch the QT version of the app.

XFCE

An "About This Computer" item will be added to the System menu.

Test/Demo Plan

Check that for common hardware (everything testers can get their hands on and more), that About This Computer correctly detects the Ubuntu version, the processor and the RAM size (with appropriate and correct scaling/rounding), along with the desktop environments that the user has installed.

See Also


CategorySpec

DesktopTeam/Specs/AboutThisComputer (last edited 2012-09-04 11:08:23 by mpt)