Editing WikiChip:naming conventions

Due to how companies name their products and how other companies that use their products (or second source them) name their, there would be too much disambiguation needed for a flat naming system such as the one Wikipedia uses. Instead, WikiChip uses a simple hierarchy of pages to disambiguate everything. This page explains in detail the '''naming conventions''' we use across this Wiki to name article.

== Casing ==
Regardless of naming, '''all article names are written in lowercase'''. (See [[#Redirect Policy]])

== Organization ==

=== Chips ===
We use a simple hierarchy to organize articles. The root article is typically the designer of the product (or the company most commonly associated with the product). A separate article is used to group a collection of similar models into a family. If there is no common name for a group of chips, we still create one under a generic series name (e.g. "m51xx series"). Each model then becomes a sub-article of the family.

Examples:

{| style="width: 700px;"
|
* company
** /family
*** /chip

Final name: company/family/chip.
||
* [[intel]]
** [[intel/mcs-4|mcs-4]]
*** [[intel/mcs-4/4004|4004]]

Final name: [[intel/mcs-4/4004]]
||
* [[amd]]
** [[amd/am5x86|am5x86]]
*** [[amd/am5x86/amd-x5-133adz|amd-x5-133adz]]

Final name: [[amd/am5x86/amd-x5-133adz]]
|}

=== Other Topics ===
Most other topics follow the same general hierarchy described for chips. The root article is the main page for a specific concept with the various sub-topics as sub-articles. Tightly related topics should always be placed under a parent topic.

Examples:

{| style="width: 900px;"
|
* main topic
** sub-topic
*** possible sub-sub-topic

Final name: main topic/sub-topic/sub-sub-topic
||
* [[c]]
** [[c/standard library|standard library]]

Final name: [[c/standard library]]
||
* [[boolean algebra|boolean algebra]]
** [[boolean algebra/majority function|majority function]]

Final name: [[boolean algebra/majority function]]
|}

=== Other ===
For all other types of pages the really generic organization should be applied:

* concept
** dependent concept
*** specialized instances of the dependent concept.

== Redirect Policy ==
Since all article names are in lower case, appropriate redirects should be create to make it easier for people to find an article using the common name (which may or may be the same as the actual model/product name). Below is a number of redirects that most chip models should have.

* Full common name
* Full common name, all lowercase
* Common name, just family/model, if applicable
* Common name, just family/model all alowercase, if applicable
* Model number
* Model number all lowercase
* /proc/cpuid name (See [[WikiChip:model numbers]])
* Part number
* Part number all lowercase

(if applicable)
* S-Spec number
* S-Spec number all lower
* Q-Spec number
* Q-Spec number all lower

Example:

E.g. '''Intel Core i7-4770R''':
* Common: [[intel/core i7/i7-4770r]]
* [[Intel Core i7-4770R]]
* [[intel core i7-4770r]]
* [[Core i7-4770R]]
* [[core i7-4770r]]
* [[i7-4770R]]
* [[i7-4770r]]
* [[Intel(R) Core(TM) i7-4770R CPU @ 3.20GHz]]


In the case of an ambiguity, a disambiguation page should be created. Also note that normally you do not need to manually set up a redirect for things such as model number, part number, and s-spec. We have a bot that periodically does it automatically.

== Title ==
Due to our hierarchical naming convention, the article title become rather ugly. Take for example the article [[intel/core i7/i7-4770r]]. We wouldn't want all that in the title. What we normally do is use a decorated title which on wikichip is enclosed inside a <code><nowiki>{{XXX title|title}}</nowiki></code> template. For example, for [[AMD]] we have {{template|amd title}} which is used by simple giving it a more concise name. For example for the {{amd|Am486}} article we used <code><nowiki>{{amd title|Am486}}</nowiki></code> which results in the nicer article topic: "Am486 - AMD".

== Linking ==
Due to how we name things it could get a bit cumbersome to link to various pages. To help with that we have a number of helpful templates that should be used:

* {{template|\}} - Links to a subpage
* {{template|\\}} - Links to a sibling page (subpage from the same parent article)
* <nowiki>{{XXX|article}}</nowiki> - Links to a specific subpage, where XXX is one of many possible things. (e.g. <code><nowiki>{{c|topic}}</nowiki></code>, <code><nowiki>{{intel|MCS-80}}</nowiki></code>, <code><nowiki>{{amd|Opteron}}</nowiki></code>, etc..).

Note that proper casing can be used in all of the above template. They will lowercase the name for link automatically.