[prev in list] [next in list] [prev in thread] [next in thread] 

List:       kde-usability
Subject:    Re: konqueror
From:       Eric Ellsworth <whalesuit () softhome ! net>
Date:       2003-01-31 22:50:06
[Download RAW message or body]

Here's a good example of the usability XML.  The XSD is an XML schema for the 
usability XML.  Have at.

If you have a validator that does schema, you can validate the XML you write.  
If not, do try to make the reproduction and rationale thorough.

Cheers,

Eric
["kde_usability_report.xsd" (text/xml)]

<?xml version="1.0"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
targetNamespace="http://usability.kde.org"
xmlns="http://usability.kde.org"
elementFormDefault="qualified">
<xs:element name="report">
    <xs:complexType>
      <xs:sequence>
        <xs:element name="author">
  	<xs:complexType>
		<xs:attribute name="name" type="xs:string" use="required"/>
		<xs:attribute name="email" type="xs:string" use="required"/>
	</xs:complexType>
	</xs:element>
        <xs:element name="application">
  	<xs:complexType>
		<xs:attribute name="name" type="xs:string" use="required"/>
		<xs:attribute name="version" type="xs:string" use="required"/>
	</xs:complexType>
	</xs:element>
        <xs:element name="os" maxOccurs="1" minOccurs="0">
  	<xs:complexType>
		<xs:attribute name="name" type="xs:string" use="required"/>
		<xs:attribute name="version" type="xs:string" use="required"/>
	</xs:complexType>
	</xs:element>
        <xs:element name="interface" maxOccurs="1" minOccurs="0">
  	<xs:complexType>
		<xs:attribute name="name" type="xs:string" use="required"/>
		<xs:attribute name="version" type="xs:string" use="required"/>
	</xs:complexType>
	</xs:element>
        <xs:element name="issue"
	  maxOccurs="unbounded" minOccurs="1">
	  <xs:complexType>
	    <xs:sequence>
	      <xs:element name="title" type="xs:string"/>
	      <xs:element name="description" type="xs:string"/>
	      <xs:element name="reproduction"
	        maxOccurs="unbounded" minOccurs="0">
		<xs:complexType>
		  <xs:sequence>
		    <xs:element name="step" type="xs:string"
		      maxOccurs="unbounded" minOccurs="1"/>
		  </xs:sequence>
		</xs:complexType>
	      </xs:element>
	      <xs:element name="solution">
	        <xs:complexType mixed="true">
		  <xs:sequence>
		    <xs:element name="rationale" type="xs:string"
		    maxOccurs="1" minOccurs="0"/>
		  </xs:sequence>
		</xs:complexType>
	      </xs:element>
	    </xs:sequence>
	    <xs:attribute name="severity" type="severity_att" use="optional"/>
	    <xs:simpleType name="severity_att">
	      <xs:restriction base="xs:string">
	        <xs:enumeration value="low"/>
	        <xs:enumeration value="medium"/>
	        <xs:enumeration value="high"/>
	        <xs:enumeration value="critical"/>
	    </xs:restriction>
	  </xs:simpleType>
	  </xs:complexType>
 	</xs:element>
      </xs:sequence>
    <xs:attribute name="date" type="xs:date" use="required"/>
  </xs:complexType>
</xs:element>
</xs:schema>

["konqueror-usability.xml" (text/xml)]

<?xml version="1.0"?>
<report date="2002-06-01"
xmlns="http://usability.kde.org"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="kde_usability_report.xsd">
  <author name="Gordon Tyler" email="gordon@doxxx.net"/>
  <application name="Konqueror" version="3.0.1"/>
  <os name="Linux" version="2.4.18"/>
  <interface name="KDE" version="3.0.1"/>

  <issue severity="3">
    <description>Navigation panel: Tabs like Network and Services can be
      removed by the user but not added</description>
    <solution>Make these tabs available for adding in the Add New
      menu/dialog
      <rationale>
      This solution make sure the user can undo any deletions
      </rationale>
      </solution>
  </issue>

  <issue severity="3">
    <description>Navigation Panel: Home tab is not selected when the user's home
      directory is opened either from the Desktop or from the Home icon on the
      panel</description>
    <reproduction>
      <step>Open the Home directory by clicking on the Home icon on the
        panel</step>
      <step>Select a navigation panel other than Home, e.g. Bookmarks</step>
      <step>Close the window</step>
      <step>Re-open the Home directory by clicking on the Home icon on the
        panel</step>
      <step>Observe that the Bookmarks are still being shown in the navigation
        panel</step>
    </reproduction>
    <solution>Always show the Home navigation panel when opening the Home
      directory in a new Konqueror window
      </solution>
  </issue>

  <issue severity="2">
    <description>Navigation Panel: Order of the tabs are illogical</description>
    <solution>The default ordering of the tabs should be: Home, Root, Network,
      Bookmarks, History, Sidebar Media Player, Services</solution>
  </issue>

  <issue severity="2">
    <description>Navigation Panel: Tabs cannot be re-ordered</description>
    <solution>Multiple solutions: 1, Drag a tab to a new position; 
      2, "Change Order" menu item on context menu displays a dialog box, 
      with a list of the items and buttons to move them up/down</solution>
  </issue>
  
  <issue severity="2">
    <description>Navigation Panel: New tabs are added above the History 
    tab</description>
    <solution>New tabs should be added at the end of the list</solution>
  </issue>
  
  <issue severity="1">
    <description>Navigation Panel: Confusing difference between Network tab 
      and LAN Browser in Services tab</description>
    <solution>Combine Network tab and LAN Browser service into single Network 
      tab, renaming LAN Browser to Local Network</solution>
  </issue>
  
  <issue severity="1">
    <description>Navigation Panel: Separate menu items for changing icon and 
      URL in tab context menu</description>
    <solution>Properties menu item which shows Properties dialog with icon 
      button, URL field, etc.</solution>
  </issue>
  
  <issue severity="1">
    <description>Navigation Panel: Select Type dialog for adding new Directory 
      tab has an editable combobox for no obvious reason</description>
    <solution>Make combobox non-editable</solution>
  </issue>
  
  <issue severity="1">
    <description>Navigation Panel: Select Type dialog for adding new Directory 
      tab is far wider than necessary</description>
    <solution>Shrink dialog to half it's current size</solution>
  </issue>

  <issue severity="1">
    <description>Navigation Panel: Why is adding a Sidebar Media Player
      different from adding a Directory?</description>
    <solution>Single menu item, "Add New Tab", which displays a dialog which
      allows the user to choose from Directory, History, Bookmarks, Sidebar
      Media Player, etc. using a layout that can handle additions to that
      list</solution>
  </issue>
</report>

_______________________________________________
kde-usability mailing list
kde-usability@mail.kde.org
http://mail.kde.org/mailman/listinfo/kde-usability

[prev in list] [next in list] [prev in thread] [next in thread] 

Configure | About | News | Add a list | Sponsored by KoreLogic