X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;f=help%2Flist;h=7d4895f65b049cf15992961b5357e139ae9db39a;hb=8ecaf9b081089e13d68fffd1c59b595a7485e66d;hp=3b37d5c0d04dbed8fcfe70cc210cc1fe6c17d444;hpb=cc78a6270fbcdb03f8885593df30cbcfc66b302c;p=pciids.git
diff --git a/help/list b/help/list
index 3b37d5c..7d4895f 100644
--- a/help/list
+++ b/help/list
@@ -1,37 +1,49 @@
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, in top left corner) and global (editing your profile, in top right corner).
-
- Hierarchy â lists all parental items.
-
- Item status â contains current name and comment.
-
- 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