help/newitem

   1 Adding a new item
   2 <p>
   3 If you know about an ID which is not listed in the database, you are welcome
   4 to submit a new entry.
   5 <p>
   6 To add it, browse to its parent entry, click on the <a href='$AC_URL$newitem'>add item</a> link
   7 and enter the last part of the new ID (without the parent ID) together with its name.
   8 For example, when you want to submit the PCI device <tt>1234:5678</tt> (vendor ID <tt>1234</tt>,
   9 device ID <tt>5678</tt>) and the vendor <tt>1234</tt> already exists, go to the page of
  10 that vendor and enter a new item with ID <tt>5678</tt> there.
  11 <p>
  12 If you want to change an existing entry, just <a href='$HELP_URL$newdiscuss'>post a discussion
  13 item</a> instead.
  14 <p>
  15 You can also add a note to the name. The notes are distributed together with the ID's,
  16 so they should be used only in important cases (for example to draw attention to the fact
  17 that the ID was used by a different company due to a mistake).
  18 <p>
  19 If you want to comment on anything, feel free to post a discussion comment. (Unlike
  20 the note, it is only kept for other people editing the lists, not distributed to
  21 users.)
  22 <p>
  23 After you submit the change, it will wait for approval by an admin.
  24
  25 <h2>Rules</h2>
  26 <p>
  27 <em>There is a couple of simple rules you should obey:</em>
  28 <ul>
  29         <li>Avoid generic names like "unknown network card", they are not
  30         likely to help anybody.
  31         <li>Prefer chip names over marketing names. If you know both,
  32         please include the marketing name in square brackets
  33         (e.g., "<tt>3c595 100BaseTX [Vortex]</tt>").
  34         <li>Do not repeat the name of the vendor in the name of the device.
  35         <li>Look at the names of similar devices and follow the same form.
  36         <li>Verify the kind of the entry: do not submit subsystems as devices,
  37         do not submit USB ID's to the PCI lists :-)
  38 </ul>
  39 <p>If you are not familar with the syntax of the ID's, please check the description:
  40 <ul class='navigation'>
  41         <li><a href='$HELP_URL$pci'>PCI devices</a>
  42         <li><a href='$HELP_URL$pci_class'>PCI device classes</a>
  43 </ul>
  44
  45 <h2>Approval</h2>
  46 <p>
  47 All submissions are checked by the administrators for errors. The admins either approve
  48 the entry, or ask you to correct it or to provide more details. In cases of blatant
  49 abuse (spam in comments etc.), they have the power to remove the entry completely.
  50 <p>
  51
  52 <h2>Notification subscription</h2>
  53 <p>
  54 If the subscribe checkbox is checked, a notification on the new item will be created for you.
  55 For more information about notifications look at <a href='$HELP_URL$notifications'>their documentation</a>.
  56
  57 <h2>See also</h2>
  58 <p>
  59 Once an item is submitted, it is not sealed for ever. You can <a href='$HELP_URL$newhistory'>discuss</a> existing items and suggest new names for them.
  60 <p>
  61 If you are interested in changes in some item (or in its whole subtree), you can let the system send you <a href='$HELP_URL$notifications'>notifications</a>.