X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;f=help%2Flist;h=cd7865e0ce1c4676c540f4c1df396ebbfadece14;hb=a800eab36c98d0b7c05a92406e44183c5d1ef3fe;hp=03987cd5915df798305b4c7d4a781135b814e139;hpb=7e93b7296184cc12c7267156b91600bffc1dd195;p=pciids.git
diff --git a/help/list b/help/list
index 03987cd..cd7865e 100644
--- a/help/list
+++ b/help/list
@@ -1,39 +1,55 @@
Browsing ID list
-You can examine the current list of IDs.
-The IDs are organized into a tree.
+You can browse the list of ID's, including the history of the entries.
+
+The ID's are organized in the form of a tree. The top level lists vendors,
+the next level enumerates their devices and the bottommost level shows the
+subsystems. Other lists, like the list of classes, are organized in a similar
+way.
Page anatomy
-Page is divided into parts:
+The page is divided into several parts:
- - Menu â you can perform actions, both in connection with current item (like adding a new sub-item) and global (editing your profile). Placed in the top left corner.
-
- Hierarchy â lists all parental items. Placed in the top right corner.
-
- Discussion â contains history of suggested names, notes and general talk about current item.
-
- List of sub-items â all direct sub-items are listed here and you can browse into them.
+
- Menu â you can perform actions, both in connection with current item (like adding a new sub-item, in the top left corner) and global (editing your profile, in the top right corner).
+
- Hierarchy â lists all parent items.
+
- Item status â contains the current name and the attached comment.
+
- Discussion â contains the history of suggested names, notes and general talk about the current item.
+
- List of sub-items â all direct sub-items of the current item are listed here and you can descend into them.
-You can find menu and hierarchy in most other pages and they have the same function.
+You can find the menu and the hierarchy in most other pages; they work in similar way there.
Colors
-Colors are used both in discussion and list of sub-items to mark status of discussion comments and sub-items respectively.
-Green entries are discussion comments which provide current item name.
-Grey ones are entries with some problem. They are either items without any assigned name (discussion about non-existing item, new item which was not yet approved by an admin) or discussion comments not yet seen by an admin.
-White ones are the rest, usual discussion and valid items.
+
+Colors are used in both the discussion and the list of sub-items to mark status of discussion comments and sub-items respectively.
+
+
Green entries are discussion comments that provide the current item name
+– the "active" ones.
+
+
Grey entries are those which need attention: They are either items without
+any assigned name (either discussion about a not-yet-existing item, or a new item which was not yet approved by
+an admin), or discussion comments not yet seen by an admin.
+
+
White ones are the rest: regular discussion and approved items.
Example