Template:VIC/doc

From Wikimedia Commons, the free media repository
Jump to: navigation, search

Usage[edit]

{{VIC
  |image=foo.jpg
  |date=yyyy-mm-dd
  |nominator=[[User:UserName|UserName]]
  |scope=Scope of the nomination
  |orientation=landscape|portrait (default:landscape)
  |status=nominated|supported|discussed|withdrawn|opposed|promoted|declined
  |review=
* {{Support}}|{{Oppose}}|{{Neutral}}|{{Question}}|{{Comment}}|{{Info}} A user review... -- ~~~~
* ...
}}

Parameters[edit]

image (Required)[edit]

This is the image name (without the Image: prefix).

date (Required)[edit]

This is the date and time the image was nominated for VI. When nominating, this is automatically set to the correct value using the default {{subst:VI-time}} value in the VIC nomination preload template. The date format shall adhere strictly to the format

YYYY-MM-DD HH:MM (UTC)

to assure proper sorting of candidates in the maintenance subcategories of Category:Valued image candidates.

nominator (Required)[edit]

The user who has nominated the image as a candidate for VIC, e.g., [[User:UserName|UserName]]. Can conveniently be specified as the user signature without a timestamp, that is ~~~ (three tildes). The nominator is not allowed to vote.

orientation[edit]

This is the image orientation parameter. The default value is landscape.

landscape[edit]

With this setting of the orientation parameter, the image is rendered at an image width of 480 pixels. With a normal 4:3 aspect ratio of a landscape image, this will result in a height of 360 pixels.

portrait[edit]

With this setting of the orientation parameter, the image is rendered with an image width of 360 pixels. With a normal 3:4 aspect ratio of a portrait image, this will result in a height of 480 pixels.

panorama[edit]

With this setting of the orientation parameter, the image is rendered with an image width of 830 pixels. This results in the same number of shown pixels as a standard 480x360 pixels image for panoramas with an aspect ratio of 1:4, which is a typical value.

scope (required)[edit]

By nominating an image for VI status you are stating that, in your view, the image is more valuable than any other on Commons within the generic scope you have specified.

Note that scope is not a simple description of your image. Rather, it defines a generic field or category within which your image is the most valuable example. Please read Commons:Valued image scope.

status (Required)[edit]

The status parameter indicates the current state of the valued image candidate in the review process. This is updated during the review procedure. The valid (case-sensitive) states are listed in the following.

If the status parameter differs from one of the listed valid states a help message is shown to the user and the VIC is automatically associated with Category:Valued image candidates with an invalid status parameter. Under normal circumstances this category should not contain any subpages.

nominated[edit]

This is the initial state of the VIC when it is first published for review. The VIC retains this state until a {{Support}} or {{Oppose}} vote has been cast. If a candidate has been in the nominated state for at least 7 days it can be closed as undecided. The candidate can also be withdrawn by the nominator. All VICs with the nominated state are automatically associated with Category:Nominated valued image candidates.

supported[edit]

This is the state the VIC is set to when one or more {{Support}} votes have been cast, but no {{Oppose}} votes. After a period of 7 days in this state, the VIC can be promoted, thereby closing the VIC for further votes. All VICs currently in the supported state are automatically associated with Category:Supported valued image candidates.

opposed[edit]

This is the state the VIC is set to when one or more {{Oppose}} votes have been cast, but no {{Support}} votes. After a period of 7 days in this state, the VIC can be declined, thereby closing the VIC for further votes. All VICs currently in the opposed state are automatically associated with Category:Opposed valued image candidates.

discussed[edit]

This is the state the VIC is set to when there is at least one {{Support}} vote and at least one {{Oppose}} vote. The VIC may be promoted or declined based on a majority vote at least 7 days after the first vote and at least 48 hours after the last vote. If there is no majority at that time the nomination can be closed as undecided. All VICs currently in the discussed state are automatically associated with Category:Discussed valued image candidates.

withdrawn[edit]

The creator, uploader or nominator can withdraw the nomination at any time, when the VIC is in one of the the states: nominated, supported, opposed, or discussed. This is done by changing the state to "withdrawn". In the withdrawn state no further comments may be added. However, the user who has withdrawn the VIC, is allowed to change his mind and revert the withdrawal. On next VIC maintenance cycle the state is changed to declined. Once in the "declined" state the withdrawal cannot be reverted. All VICs currently in the withdrawn state are automatically associated with Category:Withdrawn valued image candidates.

[edit]

When a VIC has been in the supported state for at least 7 days it can be promoted to a valued image. An alternative path to promoted is via the discussed state. Once promoted, the VIC entry for the image is closed for further votes and comments. All promoted VICs are automatically associated with Category:Promoted valued image candidates.

declined[edit]

When a VIC has been in the opposed state for at least 7 days its candidacy for valued image can be declined. An alternative path to be declined is via the discussed or withdrawn states. Once declined, the VIC entry for the image is closed for further votes and comments. An image which has been declined as a VIC cannot be nominated for VIC again within the same scope unless one or more of the issues which led to failure has been addressed. Previous votes are reset upon (re)nomination. All declined VICs are automatically associated with Category:Declined valued image candidates.

undecided[edit]

When a VIC has been nominated for at least seven days without any {{Support}} or {{Oppose}} votes it can be closed as undecided and removed from the candidates list. An undecided VIC can be (re)nominated for VIC within the same or a different scope. In that case the existing review page is reused and previous votes (if any) are reset. All undecided VICs are automatically associated with Category:Undecided valued image candidates.

review[edit]

This parameter is the review section where users cast there votes or comments. The parameter is empty at the time of nomination.

Examples[edit]

Nominating a landscape Image for VIC[edit]

{{VIC
 |image=Mwamongu water source.jpg
 |date=2007-01-12
 |nominator=[[User:Wsiegmund|Wsiegmund]]
 |scope=an unsafe water source.
 |status=nominated
 |review=
*{{Info}} A photograph of a domestic water source in the village 
of Mwamongu in Tanzania, a location away from tourist areas, 
it illustrates unsafe drinking water, a problem for a majority 
of the seven hundred million people in Africa. -- [[User:Wsiegmund|Wsiegmund]]
}}

gives

nominated
Image Mwamongu water source.jpg
Nominated by Wsiegmund on 2007-01-12
Scope Nominated as the most valued image on Commons within the scope:
an unsafe water source.
Review
(criteria)
  • Pictogram voting info.svg Info A photograph of a domestic water source in the village of Mwamongu in Tanzania, a location away from tourist areas, it illustrates unsafe drinking water, a problem for a majority of the seven hundred million people in Africa. -- Wsiegmund

How to review an image[edit]

Any registered user can review the valued image candidates. Comments are welcome from everyone, but neither the nominator nor the original image author may vote (that does not exclude voting from users who have edited the image with a view to improving it).

Nominations should be evaluated using the criteria listed at Commons:Valued image criteria. Please read those and the page on scope carefully before reviewing. Reviewing here is a serious business, and a reviewer who just breezes by to say "I like it!" is not adding anything of value. You need to spend the time to check the nomination against every one of the six VI criteria, and you also need to carry out searches to satisfy yourself on the "most valuable" criterion.

Review procedure[edit]

  • On the review page the image <!!--or image set--> is presented in the review size. You are welcome to view the image in full resolution by following the image links, but bear in mind that it is the appearance of the image at review size which matters.
  • Check the candidate carefully against each of the six VI criteria. The criteria are mandatory, and to succeed the candidate has to satisfy all six.
  • Use the where used field, if provided, to study the current usage of the candidate in Wikimedia projects. If you find usage of interest do add relevant links to the nomination.
  • Look for other images of the same kind of subject by following the links to relevant categories in the image page, and to any Commons galleries.
    • If you find another image which is already a VI within essentially the same scope, the candidate and the existing VI should be moved to Most Valued Review (MVR) to determine which one is the more valued.
    • If you find one or more other images which in your opinion are equally or more valued images within essentially the same scope, you should nominate these images as well and move all the candidates to an MVR.
  • Once you have made up your mind, edit the review page and add your vote or comment to the review parameter as follows:
You type You get When
*{{Comment}} My Comment. -- ~~~~ *Pictogram voting comment.svg Comment My comment. -- Me You have a comment.
*{{Info}} My information. -- ~~~~ *Pictogram voting info.svg Info My information. -- Me You have information.
*{{Neutral}} Reason for neutral vote. -- ~~~~ *Symbol neutral vote.svg Neutral Reason for neutral vote. -- Me You are uncertain or wish to record a neutral vote.
*{{Oppose}} Reason for opposing vote. -- ~~~~ *Symbol oppose vote.svg Oppose Reason for opposing vote. -- Me You think that the candidate fails one or more of the six mandatory criteria.
*{{Question}} My question. -- ~~~~ *Pictogram voting question.svg Question My question. -- Me You have a question.
*{{Support}} Reason for supporting. -- ~~~~ *Symbol support vote.svg Support Reason for supporting. -- Me You think that the candidate meets all of the six mandatory criteria.
  • If the nomination fails one of the six criteria, but in a way that can be fixed, you can optionally let the nominator know what needs to be done using the {{VIF}} template.
  • Your comment goes immediately before the final closing braces "}}" on the page.


How to update the status
  • Finally, change the status of the nomination if appropriate:
    • status=nominated When no votes or only neutral votes have been added to the review field (blue image border).
    • status=supported When there is at least one {{Support}} vote but no {{Oppose}} votes (light green image border).
    • status=opposed When there is at least one {{Oppose}} vote but no {{Support}} votes (red image border).
    • status=discussed When there is at least one {{Oppose}} vote and one {{Support}} vote (yellow image border).


Remember the criteria: 1. Most valuable 2. Suitable scope 3. Illustrates well 4. Fully described 5. Geocoded 6. Well categorized.

Changes in scope during the review period[edit]

The nominator is allowed to make changes in scope as the review proceeds, for example in response to reviewer votes or comments. Whenever a scope is changed the nominator should post a signed comment at the bottom of the review area using {{VIC-scope-change|old scope|new scope|--~~~~}}, and should also leave a note on the talk page of all existing voters asking them to reconsider their vote. A support vote made before the change of scope is not counted unless it is reconfirmed afterwards; an oppose vote is counted unless it is changed or withdrawn.

Help message when specifying an invalid status parameter[edit]

Let's say you want to support the nomination above, so you place a support vote and you want to update the status parameter to reflect your support. Assume you change status to "Support" (the correct is "supported") as follows

{{VIC
 |image=Mwamongu water source.jpg
 |date=2007-01-12
 |nominator=[[User:Wsiegmund|Wsiegmund]]
 |scope=an unsafe water source.
 |status=Support
 |review=
*{{Info}} A photograph of a domestic water source in the village 
of Mwamongu in Tanzania, a location away from tourist areas, 
it illustrates unsafe drinking water, a problem for a majority 
of the seven hundred million people in Africa. -- [[User:Wsiegmund|Wsiegmund]]
*{{Support}} The scope is of value to WMF projects and within that scope
I find the image is the most valued image, and it fulfills all VI criteria. -- [[User:Me|Me]]
}}

you get this

Invalid status parameter: Support

Only use lower case letters, for example status=supported. See here for a list of valid values. Then edit this page and correct the error.

Supporting a nomination[edit]

After correcting the status to "supported":

{{VIC
 |image=Mwamongu water source.jpg
 |date=2007-01-12
 |nominator=[[User:Wsiegmund|Wsiegmund]]
 |scope=an unsafe water source.
 |status=supported
 |review=
*{{Info}} A photograph of a domestic water source in the village 
of Mwamongu in Tanzania, a location away from tourist areas, 
it illustrates unsafe drinking water, a problem for a majority 
of the seven hundred million people in Africa. -- [[User:Wsiegmund|Wsiegmund]]
*{{Support}} The scope is of value to WMF projects and within that scope
I find the image is the most valued image, and it fulfills all VI criteria. -- [[User:Me|Me]]
}}

You get

supported
Image Mwamongu water source.jpg
Nominated by Wsiegmund on 2007-01-12
Scope Nominated as the most valued image on Commons within the scope:
an unsafe water source.
Review
(criteria)
  • Pictogram voting info.svg Info A photograph of a domestic water source in the village

of Mwamongu in Tanzania, a location away from tourist areas, it illustrates unsafe drinking water, a problem for a majority of the seven hundred million people in Africa. -- Wsiegmund

  • Symbol support vote.svg Support The scope is of value to WMF projects and within that scope I find the image is the most valued image, and it fulfills all VI criteria. -- Me

How to review an image[edit]

Any registered user can review the valued image candidates. Comments are welcome from everyone, but neither the nominator nor the original image author may vote (that does not exclude voting from users who have edited the image with a view to improving it).

Nominations should be evaluated using the criteria listed at Commons:Valued image criteria. Please read those and the page on scope carefully before reviewing. Reviewing here is a serious business, and a reviewer who just breezes by to say "I like it!" is not adding anything of value. You need to spend the time to check the nomination against every one of the six VI criteria, and you also need to carry out searches to satisfy yourself on the "most valuable" criterion.

Review procedure[edit]

  • On the review page the image <!!--or image set--> is presented in the review size. You are welcome to view the image in full resolution by following the image links, but bear in mind that it is the appearance of the image at review size which matters.
  • Check the candidate carefully against each of the six VI criteria. The criteria are mandatory, and to succeed the candidate has to satisfy all six.
  • Use the where used field, if provided, to study the current usage of the candidate in Wikimedia projects. If you find usage of interest do add relevant links to the nomination.
  • Look for other images of the same kind of subject by following the links to relevant categories in the image page, and to any Commons galleries.
    • If you find another image which is already a VI within essentially the same scope, the candidate and the existing VI should be moved to Most Valued Review (MVR) to determine which one is the more valued.
    • If you find one or more other images which in your opinion are equally or more valued images within essentially the same scope, you should nominate these images as well and move all the candidates to an MVR.
  • Once you have made up your mind, edit the review page and add your vote or comment to the review parameter as follows:
You type You get When
*{{Comment}} My Comment. -- ~~~~ *Pictogram voting comment.svg Comment My comment. -- Me You have a comment.
*{{Info}} My information. -- ~~~~ *Pictogram voting info.svg Info My information. -- Me You have information.
*{{Neutral}} Reason for neutral vote. -- ~~~~ *Symbol neutral vote.svg Neutral Reason for neutral vote. -- Me You are uncertain or wish to record a neutral vote.
*{{Oppose}} Reason for opposing vote. -- ~~~~ *Symbol oppose vote.svg Oppose Reason for opposing vote. -- Me You think that the candidate fails one or more of the six mandatory criteria.
*{{Question}} My question. -- ~~~~ *Pictogram voting question.svg Question My question. -- Me You have a question.
*{{Support}} Reason for supporting. -- ~~~~ *Symbol support vote.svg Support Reason for supporting. -- Me You think that the candidate meets all of the six mandatory criteria.
  • If the nomination fails one of the six criteria, but in a way that can be fixed, you can optionally let the nominator know what needs to be done using the {{VIF}} template.
  • Your comment goes immediately before the final closing braces "}}" on the page.


How to update the status
  • Finally, change the status of the nomination if appropriate:
    • status=nominated When no votes or only neutral votes have been added to the review field (blue image border).
    • status=supported When there is at least one {{Support}} vote but no {{Oppose}} votes (light green image border).
    • status=opposed When there is at least one {{Oppose}} vote but no {{Support}} votes (red image border).
    • status=discussed When there is at least one {{Oppose}} vote and one {{Support}} vote (yellow image border).


Remember the criteria: 1. Most valuable 2. Suitable scope 3. Illustrates well 4. Fully described 5. Geocoded 6. Well categorized.

Changes in scope during the review period[edit]

The nominator is allowed to make changes in scope as the review proceeds, for example in response to reviewer votes or comments. Whenever a scope is changed the nominator should post a signed comment at the bottom of the review area using {{VIC-scope-change|old scope|new scope|--~~~~}}, and should also leave a note on the talk page of all existing voters asking them to reconsider their vote. A support vote made before the change of scope is not counted unless it is reconfirmed afterwards; an oppose vote is counted unless it is changed or withdrawn.

See also[edit]