X-Git-Url: http://mj.ucw.cz/gitweb/?a=blobdiff_plain;f=help%2Fnewitem;h=4308893ffb5c2d2bbece2c731a881391bd5487e9;hb=a800eab36c98d0b7c05a92406e44183c5d1ef3fe;hp=5024b92c7aad3a5c654cdaab0d8112ed5cc7e2a8;hpb=f51a8edae9a983c45bd636b0d10109f2f4c3e46f;p=pciids.git diff --git a/help/newitem b/help/newitem index 5024b92..4308893 100644 --- a/help/newitem +++ b/help/newitem @@ -1,24 +1,46 @@ -Add a new item +Adding a new item +

+If you know about an ID which is not listed in the database, you are welcome +to submit a new entry. +

+To add it, browse to its parent entry, click on the add item link +and enter the last part of the new ID (without the parent ID) together with its name. +For example, when you want to submit the PCI device 1234:5678 (vendor ID 1234, +device ID 5678) and the vendor 1234 already exists, go to the page of +that vendor and enter a new item with ID 5678 there.

-If you know about an ID which is not listed in the database, you will be welcome -to submit it. -Just browse to the parent item and click on the add item link. If you want to change an existing entry, just post a discussion item instead.

-To create a new entry, you need to fill in the ID and its name. -The ID is just the last part (without the parent part; for example if you have PCI device -1234:5678 and the vendor 1234 already exists, you enter only 5678). -If you know chip name, it is preferred over marketing name. +You can also add a note to the name. The notes are distributed together with the ID's, +so they should be used only in important cases (for example to draw attention to the fact +that the ID was used by a different company due to a mistake).

-You can add some note to the name, for example, if the ID is not really owned by the company using it. -You can add a discussion comment to it (why you think it is correct). -The difference between note and discussion is that note is additional information to name, while discussion is administrative. -Also, note is sometimes distributed, while discussion isn't. +If you want to comment on anything, feel free to post a discussion comment. (Unlike +the note, it is only kept for other people editing the lists, not distributed to +users.)

-Both note and discussion is optional. -

-After you submit it, it will wait approval of an admin. +After you submit the change, it will wait for approval by an admin. + +

Rules

+

+There is a couple of simple rules you should obey: +

+

If you are not familar with the syntax of the ID's, please check the description: +

Approval

@@ -26,12 +48,6 @@ All submissions are checked by the administrators for errors. The admins either the entry, or ask you to correct it or to provide more details. In cases of blatant abuse (spam in comments etc.), they have the power to remove the entry completely.

-Before submitting changes, please consult the -You should check specific help for corresponding ID type: -

Notification subscription

@@ -40,6 +56,6 @@ For more information about notifications look at discuss existing items and suggest them new names. +Once an item is submitted, it is not sealed for ever. You can discuss existing items and suggest new names for them.

-If you are interested in changes in some item (or its whole subtree), you can let the system send you notifications. +If you are interested in changes in some item (or in its whole subtree), you can let the system send you notifications.