Template:WikiProject International relations/doc

This is a documentation subpage for Template:WikiProject International relations.
It may contain usage information, categories and other content that is not part of the original template page.

This template is used on approximately 86,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.

About this template

This template is the project banner for WikiProject International relations, and it can also act as a banner for its subprojects, WikiProject United Nations and WikiProject International law

The template is to be placed on talk pages (only) of the articles identified as being within the Project's scope (at or near the top of the talkpage).

This template automatically assigns the category Category:WikiProject International relations articles to the articles' talk pages. This category and other associated Project categories are used in various ways by the Project in the overall management of the Project's workload.

This template contains optional parameters, details of usage are given below.

Usage instructions

Full syntax options for the {{WikiProject International relations|class=|importance=|un=|un-importance=|law=|law-importance=}} template are as follows:

{{WikiProject International relations
 |class= 
 |importance=
 |un= <!-- yes, if applicable -->
 |un-importance=
 |law= <!-- yes, if applicable -->
 |law-importance=
 |attention=
 |needs-infobox=
 |listas=
}}

The parameters are named, and (if used) must be entered exactly as-is (note, all are lowercase).

Parameter values

Class

class – valid values are listed in the custom class mask. See the project's quality scale for details. Setting an explicit value of NA is rarely necessary; for this, either leave |class= blank or omit the parameter.

This optional parameter records the Project quality assessment rating currently assigned to the particular article on whose talkpage the project banner appears.

If unassigned, or an invalid value is given, the parameter defaults to "unassigned" and the template places the talkpage into Category:Unassessed International relations articles.

Valid values for this parameter, their associated meanings and categories are given in the table below. Values should be typed as shown (e.g. |class=GA ):

**Class parameter values** (Category:International relations articles by quality)
Value	Meaning	Main Category	UN Category
FA	Featured-class articles; the article has passed through the featured article review process.	FA-Class International relations articles	FA-Class United Nations articles
A	A-class articles; could be submitted as a Featured article candidate; probably could use some small updates to make it Featured quality.	A-Class International relations articles	A-Class United Nations articles
GA	Good-class articles; the article has passed through the good article review process.	GA-Class International relations articles	GA-Class United Nations articles
B	B-class articles; could be submitted as a Good article nominee; probably could use some updates or may lack some features from the Good article criteria, but it presents a good overview of the subject.	B-Class International relations articles	B-Class United Nations articles
Start	Start-class articles; the article is more than a stub, but may lack some important aspects of the topic's discussion.	Start-Class International relations articles	Start-Class United Nations articles
Stub	Stub-class articles; the article is a stub; it likely contains one of the stub templates.	Stub-Class International relations articles	Stub-Class United Nations articles
FL	Featured-class lists; the article has passed through the featured list review process. They are sorted with the featured articles.	FA-Class International relations articles	FA-Class United Nations articles
List	The article is a list that has not yet passed the featured list review process.	List-Class International relations articles	List-Class United Nations articles
NA	Not applicable; the page is not an article and should not be rated; it could be an image or category, for example.	NA-Class International relations articles	NA-Class United Nations articles

Importance

importance – valid values are: top, high, mid, low, na (case-insensitive). See the project's importance scale for details. Setting an explicit value of NA is rarely necessary; for this, either leave |importance= blank or omit the parameter.

This optional parameter records the Project importance assessment rating currently assigned to the particular article on whose talkpage the project banner appears.

If unassigned, or an invalid value is given, or the class parameter is set to "NA", the parameter defaults to "unassigned" and the template places the talkpage into Category:Unknown-importance International relations articles.

Valid values for this parameter, their associated meanings and categories are given in the table below. Values should be typed as shown (e.g. |importance=Mid ):

**Importance parameter values** (Category:International relations articles by importance and Category:United Nations articles by importance)
Value	Meaning	Main Category	UN Category
Top	Reserved for the primary articles. These are considered fundamental to the topic and are mostly overview articles with many links.	Top-importance International relations articles	Top-importance United Nations articles
High	Major topic about International relations; and for needed subtopics of "key" articles	High-importance International relations articles	High-importance United Nations articles
Mid	For general articles on more specialised (sub-)topics.	Mid-importance International relations articles	Mid-importance United Nations articles
Low	For still notable, but more highly specialised or even obscure topics.	Low-importance International relations articles	Low-importance United Nations articles

Sub-projects

un – set |un=yes if the article is supported by WikiProject United Nations.
- This parameter populates Category:WikiProject United Nations articles, and the relevant subcategory of Category:United Nations articles by quality based upon the |class= parameter.
- un-importance (only used if |un=yes is set; uses the same values as |importance=) – Importance rating within WikiProject United Nations
  - This importance rating populates the relevant subcategory of Category:United Nations articles by importance.
law – set |law=yes if the article is supported by WikiProject International law.
- This parameter populates Category:WikiProject International law articles, and the relevant subcategory of Category:International law articles by quality based upon the |class= parameter.
- law-importance (only used if |law=yes is set; uses the same values as |importance=) – Importance rating within WikiProject International law
  - This importance rating populates the relevant subcategory of Category:International law articles by importance.

Optional

attention – set |attention=yes if the article needs immediate attention from experienced editors. Use only if another parameter does not cover the need for attention; this should be used sparingly. It is strongly encouraged to also add a section to the talk page explaining what needs attention.
- This parameter populates Category:International relations articles needing attention.
needs-infobox – set |needs-infobox=yes if the article needs an infobox. Remember that infoboxes are not suitable for all articles, and can overwhelm short articles.
- This parameter populates Category:International relations articles needing infoboxes.
listas – This parameter, which is the equivalent of the DEFAULTSORT sortkey that should be placed on all biographical articles, is a sortkey for the article talk page (e.g. for John Doe, use |listas=Doe, John so that the talk page will show up in the D's and not the J's of the various assessment and administrative categories). This is important because it is one source used by those who set DEFAULTSORT on the article; consider also setting the DEFAULTSORT for the article when setting this parameter. For more information about this, please see Wikipedia:Categorization of people § Ordering names in a category.
If the article is using {{WikiProject banner shell}} then it is preferable to add |listas= to that template instead of a project banner template. Putting the parameter on more than one template is not required.
category – set |category=no if, and only if, a banner is being used for demonstration or testing purposes, to prevent unnecessary or undesirable categorization. Otherwise, omit this parameter.