]> mj.ucw.cz Git - pciids.git/blob - help/newitem
More revisions of the help.
[pciids.git] / help / newitem
1 Add a new item
2 <p>
3 If you know about an ID which is not listed in the database, you will be welcome
4 to submit it.
5 Just browse to the parent item and click on the <a href='$AC_URL$newitem'>add item</a> link.
6 If you want to change an existing entry, just <a href='$HELP_URL$newdiscuss'>post a discussion
7 item</a> instead.
8 <p>
9 To create a new entry, you need to fill in the ID and its name.
10 The ID is just the last part (without the parent part; for example if you have PCI device
11 <tt>1234:5678</tt> and the vendor <tt>1234</tt> already exists, you enter only <tt>5678</tt>).
12 If you know chip name, it is preferred over marketing name.
13 <p>
14 You can add some note to the name, for example, if the ID is not really owned by the company using it.
15 You can add a discussion comment to it (why you think it is correct).
16 The difference between note and discussion is that note is additional information to name, while discussion is administrative.
17 Also, note is sometimes distributed, while discussion isn't.
18 <p>
19 Both note and discussion is optional.
20 <p>
21 After you submit it, it will wait approval of an admin.
22
23 <h2>Approval</h2>
24 <p>
25 All submissions are checked by the administrators for errors. The admins either approve
26 the entry, or ask you to correct it or to provide more details. In cases of blatant
27 abuse (spam in comments etc.), they have the power to remove the entry completely.
28 <p>
29 Before submitting changes, please consult the 
30 You should check specific help for corresponding ID type:
31 <ul class='navigation'>
32         <li><a href='$HELP_URL$pci'>PCI devices</a>
33         <li><a href='$HELP_URL$pci_class'>PCI device classes</a>
34 </ul>
35
36 <h2>Notification subscription</h2>
37 <p>
38 If the subscribe checkbox is checked, a notification on the new item will be created for you.
39 For more information about notifications look at <a href='$HELP_URL$notifications'>their documentation</a>.
40
41 <h2>See also</h2>
42 <p>
43 Once item is submitted, it is not sealed for ever. You can <a href='$HELP_URL$newhistory'>discuss</a> existing items and suggest them new names.
44 <p>
45 If you are interested in changes in some item (or its whole subtree), you can let the system send you <a href='$HELP_URL$notifications'>notifications</a>.