Registry Dictionary

Writing Guideines

If you don't have a javscript-capable browser, you can only add, edit and remove entries from the main menu. Just make sure you type the key and value in correctly - currently there is no way to rename an entry. If you do have a javascript-capable browser, you can also add, edit and remove entries using the buttons that pop up in the pages of the Dictionary once you have logged in.

With the "Edit" and "Remove" buttons, which pop up in descriptions which you are allowed to change, you can edit the entry you're looking at right away by pressing the "Edit" button, or remove it with the "Remove" button.

The "Add" button pops up in key indexes. You can use it to add a key or value under that key. If you type something into the "Key" field but leave the "Value" field blank and then press the "Add" button, you create (or edit) a key. If you leave the "Key" field blank but enter something into the "Value" field, you create or edit a value. You can create or edit an arbitrary key or value anywhere under that key by typing the right things into both fields. Finally, you can create an entry for the current key by leaving both fields blank. Note that there is a reason for having seperate fields for the key and value; in the Windows Registry, you can actually use the "\" character, which is used to seperate keys in a key path, in value names! So without separate fields, there's no way to distinguish a "\" that's part of a value name and one that's a key name seperator.

You can write entries in three formats; proportional text, monospaced text, and HTML. You probably want to use proportional text most of the time. Monospaced text looks kinda ugly in comparison, but it is useful if you want a formatted text table. If you are allowed to use HTML (your rank has been upgraded), make sure you check the page after you have written the entry, to make sure that it comes out right.

Each entry must have a confidence level. Also, there are for settings for each of the four platforms - Windows 3.1, Windows 95, Windows NT and Windows CE. Note that you don't have to be terribly accurate with those settings - if you have a confidence level of then you are allowed to say that the entry applies to a certain platform even if you're not totally sure that it does. Add in everything you know, even if it is just speculation. The whole idea of this system is to share information about the Registry. Your speculation could help someone else figure out something they didn't already know, and thus help the amount of information in the Dictionary to grow. So if you're not sure of something, write it anyway, and tell us why you're not sure. Let the readers make appropriate judgements from that.

Don't repeat information if it's not necessary. There are many cases where the two values in different parts of the Registry have the same purpose. In that case, just point one entry to the other one, maybe using a link if you can write in HTML.

Also, there are many places where there is no set name, for a key or value, but the name itself is used to convey data. An example is HKEY_CLASSES_ROOT - all of the keys under this key refer to an OLE/COM/ActiveX class. In cases like these, create a key or value called "SAMPLE" or something appropriate, and explain what each key or value of that type does.

The same applies for other information. If there is something that you can't convey because of the limitations of the Dictionary, e.g. a certain value applies to both 95 and NT, but has different meanings for each, simply explain this in the actual description.

no swearing! :)