View source for Wiki143:Portal/Guidelines

{{Short description|Failed proposal for guidelines on portals}}
{{Failed|WP:POG|WP:PORTG}}
{{nutshell|A portal helps to browse on a particular subject, hence the subject of a portal should be broad so that it presents a diversified content.}}
{{Portal information sidebar}}
This page outlines best practices for [[Wikipedia:Portals|portals]].

Please bear in mind that portals should be about broad subject areas, which are likely to attract large numbers of interested readers and portal maintainers. Portals which require manual updating are at a greater risk of nomination for deletion if they are not kept up to date. Do not expect other editors to maintain a portal you create.{{Disputed inline}}

== In general ==
A portal helps to browse on a particular subject, hence the subject of a portal should be broad so that it presents a diversified content. The portal subject area should have enough interest and articles to sustain a portal, including enough quality content articles above a Start-class to sustain the featured content section. To aid in this, the portal should be associated with a WikiProject (or have editors with sufficient interest)<ref name=milhistquote >"You don't have to join our project to work on military history articles. We welcome everyone who wants to help improve these topics, and encourage you—project member or not—to participate in all of our activities and take complete advantage of the support we offer." </ref> to help ensure a supply of new material for the portal and maintain the portal. 

The portal layout should be complete or there should be ongoing efforts to make the portal layout complete.  The portal should be maintained and serve a useful purpose.

Portals should not be a vehicle for advocacy or advertisement, should not have too many red links, should not be redundant to another portal, should not cover too narrow a scope, and should adhere to Wikipedia's policy on [[WP:POV|neutrality]]. For speedy deletion of portals, see [[Wikipedia:CSD#Portals]] and for deletion by discussion see [[WP:MFD]].

It is common practice not to include references in portals. As on the [[Main Page]], readers should be able to [[WP:V|verify]] the portal content by following a prominent link to a relevant article, and checking the references there.

== How to create a portal ==
Before creating a portal, see [[Wikipedia:Contents/Portals]].

==What content to include==
===Required===
* '''Introduction''' – A short summary of the topic.  If possible, this should contain an attractive image emblematic of the topic.
* '''Categories''' – Links to the most important categories related to the topic.
* '''Subportals''' or '''Related Portals''' (if there are any) – Some portals have these appear near the top, just below the "Introduction" (e.g. [[Portal:Arts|Arts]] or [[Portal:Technology|Technology]]). Others have them appear near the bottom (e.g., [[Portal:Biology|Biology]] or [[Portal:Literature|Literature]]). This section is ''not'' required if a topic-specific browsebar is used (e.g., [[Portal:Religion|Religion]]).
* '''Topics''' – Links to the most important articles related to the topic.
* '''Selected article''' – A representative excerpt from one of the articles described in [[#Article selection]] below, which should be changed periodically.

===Recommended===
* '''Browsebar''' – The general {{tl|browsebar}} and/or a more specific bar of portal links such as on the [[Portal:Religion|religion]] portals
* '''Selected article''' – <s>The first instance of the article title should link to the full article.</s> (''The text must be clearly linked to the main article'')  <s>Images should not use thumbnail formatting unless the background color of the portal content is specified as "transparent" (typically in the box-header subpage).  Keep images small; 100px (as on the [[Main Page]]) is best.</s> Remember that in compliance with [[WP:NFCC]], non-free images cannot be used outside of articles.
* '''Things you can do''' – Any relevant ongoing collaborations, as well as lists of editing requests for related articles
* '''Wikimedia''', '''Other projects''', or like – Links to material on other Wikimedia projects (e.g., [[Portal:Arts/Wikimedia|Arts]])
* '''Selected picture''' – Images should have captions detailed enough for viewers to understand the context.  Be sure to test the portal at 800x600 resolution to be sure images are not too large.  Do not use thumbnails; instead, let the caption stand free below the image (e.g., [[Portal:History of science/Picture|History of science]]).
* '''Portals footer''' – The brief {{tl|portals}}.
* '''Subportals''' or '''Related Portals''' (if there are any) – Some portals have these appear near the top, just below the "Introduction" (e.g. [[Portal:Arts|Arts]] or [[Portal:Technology|Technology]]). Others have them appear near the bottom (e.g., [[Portal:Biology|Biology]] or [[Portal:Literature|Literature]]). A topic-specific browsebar may be used as an alternative (e.g., [[Portal:Religion|Religion]]).

===Optional===
* '''WikiProjects''' – A list of any WikiProjects related to the topic. This may be combined with "Things to do".
* '''In the news''' – Frequently updated headlines related to the topic (e.g., [[Portal:Politics/News|Politics]]). See the [[User:Wikinews Importer Bot|Wikinews Importer Bot]] for a method to automatically update a portal news section from [[n:Wikinews|Wikinews]] items.
* '''Did you know?''' – Interesting trivia related to the topic (e.g., [[Portal:Science/Did you know|Science]]). The number of entries should be fixed, with old entries moved to a '''Read more''' archive. See the [[Template:Random subpage|random subpage template]] for a method to display a list of randomly selected items from a group of numbered subpages (e.g., [[Portal:Sustainable development|Sustainable development]]). This template also can be used to randomly rotate items such as images within a section (e.g., the [[Portal:Philosophy of science/Intro|Philosophy of science introduction]]). DYK selections harvested automatically should be regularly curated to remove false positives and inappropriate selections.
* '''Selected biography''' – Follow the same conventions as for "Selected articles."
* '''Selected picture''' – Images should have captions detailed enough for viewers to understand the context. Images should not duplicate the image on the featured article. Be sure to test the portal at 800x600 resolution to be sure images are not too large. Do not use thumbnails; instead, let the caption stand free below the image (e.g., [[Portal:History of science/Picture|History of science]]).
* '''Selected anniversaries''' or '''On this day''' – These should be updated automatically based on the date. For broad topics, daily content is preferable (e.g., [[Portal:War/Selected anniversaries|War]]); for more specific subjects, monthly may be appropriate (e.g., [[Portal:Scouting|Scouting]]).
* '''Selected quotes''' – Add some good quotes on the topic, it can be a good additional asset to your portal (e.g. [[Portal:London|London]]).
* Many other content boxes are possible. For ideas, see [[Portal:London|London]], [[Portal:Cricket|Cricket]], and the other [[Wikipedia:Featured portals|featured portals]], or [[Portal:Browse|browse]] through other complete portals.

===Article selection===
For the ''Selected article'', ''Selected biography'' or other ''Selected content'' items, find a good number{{ref|good_number}} of articles, as many as you can, that could be showcased on the portal. Each of these articles should be:
* of high quality, either a [[WP:FA|featured article]], a [[WP:GA|good article]] or one which deals with its subject substantially or comprehensively;
* describing a major topic or person notable within the portal topic area; 
* have no tags displayed denoting clean-up, copyright violation, controversy or similar;
* not marked as a stub.
<small>{{note|good_number}}''Good number'' means about 20 articles, though this figure may vary from case to case and is intended as a rough guide rather than a hard principle.</small>

==Linking to portals==
{{See|Wikipedia:Portal#How to add portal links to articles}}
To optimise access to portals, each portal should have the following links leading to them:
#From the root article of the portal
#From the category of the same name or whatever are the root categories in the Category box section.
#From the corresponding navigation template(s)
When a portal is complete the portal should be added to [[Portal:Contents/Portals]]. Consider adding links to the portal from the selected articles.

==How often to update?==
The more often portals are updated, with fresh content, the more interesting they will be to readers and attract returning visitors.  Some portals update the selected articles and pictures once a month.{{Disputed inline}}   Others update them weekly,{{Disputed inline}}  which is preferred.  Other update schedules—ranging from once every few weeks to every time the article is refreshed—are also sometimes used.

===Queue features in advance===
One way to facilitate the updates is to queue them up in advance.  Wikipedia contains some system variables (see [[Help:Variables]]), such as <nowiki>{{CURRENTWEEK}}</nowiki>, and <nowiki>{{CURRENTMONTHNAME}}</nowiki>.  These can be incorporated into wikilinks.  

For example <nowiki>[[Selected picture/{{CURRENTMONTHNAME}}]]</nowiki> would link to <nowiki>[[Selected picture/May]]</nowiki> every May, and would automatically update to <nowiki>[[Selected picture/June]]</nowiki> the next month.  

Knowing this, you can set up several of the Selected picture monthly subpages in advance and the portal will perpetually cycle through them. You can instead use the <nowiki>{{CURRENTWEEK}}</nowiki> variable to make the selected picture update weekly, rather than monthly.

==See also==
* [[Wikipedia:Village pump (policy)/Archive 153#RFC: Formalize Standing of Portal Guidelines as a Guideline (18 July 2019)|Wikipedia:Village pump (policy)/Archive 153 § RFC: Formalize Standing of Portal Guidelines as a Guideline (18 July 2019)]] – per this discussion, which was closed on 26 September 2019 (UTC), it was determined that "there is clear consensus that the 'Portal guidelines' are not, in fact, official guidelines."
* [[Wikipedia:The Problems with Portals]] (user essay)
* [[User:DexDor/Portals]] (user essay)
* [[Wikipedia:Consultation on the future of portals]] (user essay)
* [[Wikipedia:Village pump (proposals)/RfC: Ending the system of portals]] ([[WP:ENDPORTALS]])
* [[Wikipedia:Village pump (proposals)/Archive 162#Proposal to delete Portal space]] ([[WP:ENDPORTALS2]])
* [[Wikipedia:Arbitration/Requests/Case/Portals#Community_discussion_recommended]]

==Notes==
{{reflist}}

{{Portal nav footer}}