Wikimedia:Manual of style: Difference between revisions

From Wikimedia Foundation Governance Wiki
Content deleted Content added
Tag: 2017 source edit
Marked this version for translation
 
(28 intermediate revisions by 3 users not shown)
Line 2: Line 2:
{{policy-wiki}}
{{policy-wiki}}
{{see also|Wikimedia:Editing policy}}
{{see also|Wikimedia:Editing policy}}
{{shortcut|[[MOS]]}}
<translate>
<translate>
<!--T:2-->
<!--T:2-->
Line 11: Line 12:
== General guidelines == <!--T:4-->
== General guidelines == <!--T:4-->
</translate>
</translate>
{{See also|link=m:Communications/Communicating about the Wikimedia Foundation|1=m:Communications/Communicating about the Wikimedia Foundation}}
{{See also|link=:m:Communications/Communicating about the Wikimedia Foundation|1=:m:Communications/Communicating about the Wikimedia Foundation}}
<translate>
<translate>
<!--T:5-->
<!--T:5-->
* Try to utilize English which will not be difficult to translate into other languages
* Try to utilize English words and phrases which will not be difficult to translate into other languages
* When in doubt, refer to manual of styles on Wikimedia project wikis or the [[m:Special:MyLanguage/Communications/Communicating about the Wikimedia Foundation|"Communicating about the Wikimedia Foundation" guide on Meta-Wiki]]
* When in doubt, refer to manual of styles on Wikimedia project wikis or the [[<tvar name="1">:m:Special:MyLanguage/Communications/Communicating about the Wikimedia Foundation</tvar>|"Communicating about the Wikimedia Foundation" guide on Meta-Wiki]]


=== Contractions and acronyms === <!--T:14-->
=== Contractions and acronyms === <!--T:14-->
Line 23: Line 24:


<!--T:16-->
<!--T:16-->
When using an acronym is necessary or difficult to avoid, please be sure to introduce the acronym's meaning in its usage.
When using an acronym is necessary or difficult to avoid, please be sure to introduce the acronym's meaning in its usage. (example: Wikimedia Foundation ("WMF"))

=== Dates === <!--T:115-->

<!--T:116-->
When possible the <tvar name="1">{{tl|DateT}}</tvar> template should be utilized to properly format date to a user's language and preferences. Where not possible, dates should be formatted as:

<!--T:117-->
* Year-Month-Day as YYYY-MM-DD (example: 2024-03-01)
* Day Month Year (example: 1 March 2024)

=== Gender and pronoun usage === <!--T:106-->

<!--T:107-->
Whenever possible, gender-neutral pronouns should be used.

<!--T:108-->
Requests for use of specific pronouns when referring to person making the request should be honored whenever it is possible to do so. Any limitations should be shared by the core administrators team with individual making the request.

<!--T:109-->
Existing content can be changed en masse by contacting the wiki's [[<tvar name="1">Special:MyLanguage/Wikimedia:Core administrators team</tvar>|core administrators team]].

=== Job titles === <!--T:118-->

<!--T:119-->
Job titles should be capitalized and treated as proper nouns. (examples: Chief Executive Officer, Chair, Director of Job Titles)

=== Name changes === <!--T:110-->

<!--T:111-->
Individuals requesting changes to uses of their own name, for whatever reasons (including safety or privacy), may do so by contacting the wiki's [[<tvar name="1">Special:MyLanguage/Wikimedia:Core administrators team</tvar>|core administrators team]].

<!--T:112-->
Requests for changes will be honored, including within historical content, as much as can be done. Any limitations should be shared by the core administrators team with individual making the request.

=== Project names === <!--T:120-->

<!--T:121-->
Names of Wikimedia projects should be capitalized and not shortened or abbreviated.

<!--T:122-->
Examples:

<!--T:123-->
* Meta-Wiki (not Meta)
* Wikimedia Commons (not Commons)
* English Wikipedia (not enWP)


== Title, header, and page name formatting == <!--T:6-->
== Title, header, and page name formatting == <!--T:6-->


<!--T:7-->
<!--T:7-->
Whenever possible, [[w:en:Capitalization#Sentence case|sentence case capitalization]] should be used for all titles, headers, and page names.
Whenever possible, [[<tvar name="1">{{lwp|Capitalization#Sentence case}}</tvar>|sentence case capitalization]] should be used for all titles, headers, and page names.


<!--T:8-->
<!--T:8-->
Line 51: Line 98:
* History of past departments
* History of past departments
* Information from a regular board meeting
* Information from a regular board meeting
</translate>
</translate>{{anchor|pagetitles}}
{{anchor|namespaces}}
<translate>
== Namespace placement == <!--T:17-->
</translate>
{{see also|Wikimedia:Namespaces}}
<translate>
<translate>
=== Page titles for Legal, Minutes, Policies, and Resolutions namespaces === <!--T:33-->
<!--T:18-->
Whenever possible, content should be placed within these namespaces to facilitate greater searching of content.
</translate>
;<translate><!--T:19--> Main namespace</translate>
:<translate><!--T:20--> General content or content without a clear namespace</translate>
;<translate><!--T:21--> Talk namespaces</translate>
:<translate><!--T:22--> Discussions and archives of discussions</translate>
;Wikimedia
:<translate><!--T:23--> Content specific to this Wikimedia Foundation Governance Wiki</translate>
;Policy
:<translate><!--T:24--> Wikimedia Foundation and Wikimedia Movement policies</translate>
;Resolution
:<translate><!--T:25--> Resolutions by Wikimedia Foundation Board of Trustee</translate>
;Legal
:<translate><!--T:26--> Wikimedia Foundation legal documentation</translate>
;Minutes
:<translate><!--T:27--> Minutes of Wikimedia Foundation Board of Trustee meetings</translate>
;Archive
:<translate><!--T:28--> Archived or historical content no longer in active use on this wiki and available for migration to another wiki (generally [[<tvar name="1">m:</tvar>|Meta-Wiki]])</translate>{{anchor|pagetitles}}
<translate>
== Page titles for Legal, Minutes, Policies, and Resolutions namespaces == <!--T:33-->


<!--T:34-->
<!--T:34-->
Page titles should be left for translation and not altered with <tvar name="1"><code><nowiki>{{DISPLAYTITLE:}}</nowiki></code>. Instead, the page title - with inclusion of Wikimedia or Wikimedia Foundation in title as appropriate - should be placed immediately below the <tvar name="2"><code><nowiki><languages /></nowiki></code></tvar> tag using <tvar name="3"><code>h1</code></tvar> headers (<tvar name="4"><code><nowiki>= {{int|Lqt-talkpage-history-tab}} =</nowiki></code></tvar>).
Page titles should be altered with <tvar name="1"><code><nowiki>{{DISPLAYTITLE:NAME}}</nowiki></code></tvar> as needed - with inclusion of Wikimedia or Wikimedia Foundation in title as appropriate. Pages using the <tvar name="2"><code><nowiki>{{DISPLAYTITLE}}</nowiki></code></tvar> should '''not''' have their page title's marked for translation as well.
</translate>
</translate>

=== {{int|Wikieditor-toolbar-tool-table-example}} ===
=== {{int|Wikieditor-toolbar-tool-table-example}} ===
<pre>
<pre>
<languages />
<languages />
= &#60;translate>Wikimedia Foundation Donuts Policy&#60;/translate> =
{{DISPLAYTITLE:&#60;translate>Wikimedia Foundation Donuts Policy&#60;/translate>}}
{{policy-board}}
{{policy-board}}
&#60;translate>
&#60;translate>
== Why we have a Donuts Policy ==
== Why we have a Donuts Policy ==
</pre><translate>
</pre><translate>


Line 97: Line 120:
* [[Special:MyLanguage/Policy:Universal Code of Conduct|<translate><!--T:98--> Policy:Universal Code of Conduct</translate>]]
* [[Special:MyLanguage/Policy:Universal Code of Conduct|<translate><!--T:98--> Policy:Universal Code of Conduct</translate>]]
* [[Special:MyLanguage/Policy:Terms of Use|<translate><!--T:99--> Policy:Terms of Use</translate>]]
* [[Special:MyLanguage/Policy:Terms of Use|<translate><!--T:99--> Policy:Terms of Use</translate>]]

{{anchor|namespaces}}
<translate>
<translate>


== Resolutions namespace == <!--T:29-->
== Namespace placement == <!--T:17-->
</translate>
{{see also|Wikimedia:Namespaces}}
<translate>
<!--T:18-->
Whenever possible, content should be placed within these namespaces to facilitate greater searching of content.
</translate>
;<translate><!--T:19--> Main namespace</translate>
:<translate><!--T:20--> General content, navigational pages, or content without a clear namespace</translate>
;<translate><!--T:21--> Talk namespaces</translate>
:<translate><!--T:22--> Discussions and archives of discussions</translate>
; Wikimedia
:<translate><!--T:23--> Content related to operations of [[<tvar name="1">Special:MyLanguage/Wikimedia:About</tvar>|Wikimedia Foundation Governance Wiki]]</translate>
; Policy
:<translate><!--T:24--> Wikimedia Foundation and Wikimedia Movement [[<tvar name="1">Special:MyLanguage/Policies</tvar>|policies]]</translate>
; Resolution
:<translate><!--T:25--> [[<tvar name="1">Special:MyLanguage/Resolutions</tvar>|Resolutions]] by the Wikimedia Foundation Board of Trustee</translate>
; Legal
:<translate><!--T:26--> Wikimedia Foundation [[<tvar name="1">Special:MyLanguage/Category:Legal documentation</tvar>|legal documentation]]</translate>
; Agenda
:<translate><!--T:102--> Agendas of [[<tvar name="1">Special:MyLanguage/Meetings</tvar>|Wikimedia Foundation Board of Trustee meetings]]</translate>
; Minutes
:<translate><!--T:27--> Minutes of [[<tvar name="1">Special:MyLanguage/Meetings</tvar>|Wikimedia Foundation Board of Trustee meetings]]</translate>
; Committee
:<translate><!--T:103--> Content related to committees of the Wikimedia Foundation Board of Trustee</translate>
; Endowment
:<translate><!--T:104--> Content related to the [[<tvar name="1">Special:MyLanguage/Wikimedia Endowment</tvar>|Wikimedia Endowment]]</translate>
; Memory
:<translate><!--T:105--> [[<tvar name="1">Special:MyLanguage/Institutional knowledge</tvar>|Institutional knowledge]] of the Wikimedia Foundation</translate>
; Archive
:<translate><!--T:28-->
[[<tvar name="1">Special:MyLanguage/Archive:Main</tvar>|Archived]] or historical content no longer in active use on this wiki and available for migration to another wiki (generally [[<tvar name="2">:m:Special:MyLanguage/Main Page</tvar>|Meta-Wiki]])

=== Usage of Resolutions namespace === <!--T:29-->


<!--T:30-->
<!--T:30-->
Content placed within the Resolutions namespace should be resolutions which were considered by the Wikimedia Foundation Board of Trustees. The <tvar name="1">{{tl|resolution}}</tvar> template should be used at the top of resolution pages for proper formatting.
Content placed within the Resolutions namespace should be resolutions which were considered by the Wikimedia Foundation Board of Trustees. The <tvar name="1">{{tl|resolution}}</tvar> template should be used at the top of resolution pages for proper formatting.


== Policies namespace == <!--T:31-->
=== Usage of Policies namespace === <!--T:31-->


<!--T:32-->
<!--T:32-->
Content placed within the Policies namespace should be official Wikimedia Foundation policies. The <tvar name="1">{{tl|Policy-board}}</tvar> or <tvar name="2">{{tl|Policy-staff}}</tvar> templates should be used to help with displaying information for readers.
Content placed within the Policies namespace should be official Wikimedia Foundation policies. The <tvar name="1">{{tl|Policy-board}}</tvar> or <tvar name="2">{{tl|Policy-staff}}</tvar> templates should be used to help with displaying information for readers.
</translate>
{{anchor|categories}}
<translate>
== Category placement == <!--T:100-->

<!--T:101-->
All content (pages, files, templates, etc.) on this wiki should be placed within a category that is a part of the [[<tvar name="1">:Category:All</tvar>|Category:All]] category tree:</translate>
<categorytree mode="categories">All</categorytree>
<translate>

== Translations == <!--T:113-->

<!--T:114-->
:''Please see the [[<tvar name="1">Special:MyLanguage/Wikimedia:Translations guidelines#Translations_manual_of_style</tvar>|Translations manual of style]] within the [[<tvar name="2">Special:MyLanguage/Wikimedia:Translations_guidelines</tvar>|Translations guidelines]].
</translate>
</translate>

Latest revision as of 18:25, 10 April 2024

See also: Wikimedia:Editing policy
Shortcut:
MOS

This Wikimedia Foundation Governance Wiki manual of style outlines basic guidelines which should be considered when formatting content and creating pages on this site.

At all times, the needs of the specific type of content (resolution, minutes, legal document, etc.) takes precedent over any guidelines provided on this page. These guides are more to help avoid unnecessary inconsistency and guidance where the type of content does not provide an existing framework.

General guidelines

See also: :m:Communications/Communicating about the Wikimedia Foundation

Contractions and acronyms

To make content easier to translate and understand across languages, please avoid use of contractions and acronyms.

When using an acronym is necessary or difficult to avoid, please be sure to introduce the acronym's meaning in its usage. (example: Wikimedia Foundation ("WMF"))

Dates

When possible the {{DateT}} template should be utilized to properly format date to a user's language and preferences. Where not possible, dates should be formatted as:

  • Year-Month-Day as YYYY-MM-DD (example: 2024-03-01)
  • Day Month Year (example: 1 March 2024)

Gender and pronoun usage

Whenever possible, gender-neutral pronouns should be used.

Requests for use of specific pronouns when referring to person making the request should be honored whenever it is possible to do so. Any limitations should be shared by the core administrators team with individual making the request.

Existing content can be changed en masse by contacting the wiki's core administrators team.

Job titles

Job titles should be capitalized and treated as proper nouns. (examples: Chief Executive Officer, Chair, Director of Job Titles)

Name changes

Individuals requesting changes to uses of their own name, for whatever reasons (including safety or privacy), may do so by contacting the wiki's core administrators team.

Requests for changes will be honored, including within historical content, as much as can be done. Any limitations should be shared by the core administrators team with individual making the request.

Project names

Names of Wikimedia projects should be capitalized and not shortened or abbreviated.

Examples:

  • Meta-Wiki (not Meta)
  • Wikimedia Commons (not Commons)
  • English Wikipedia (not enWP)

Title, header, and page name formatting

Whenever possible, sentence case capitalization should be used for all titles, headers, and page names.

The primary exception is using a flexible use of proper noun capitalization for policies and other content with a large external audience.

Examples of pages where proper noun capitalization is most appropriate:

  • Major Organization Policy
  • Board of Trustees
  • Official Board Committee
  • Formal Board Resolution

Examples of pages where sentence case capitalization is most appropriate:

  • Policy specific to only this wiki
  • History of past departments
  • Information from a regular board meeting

Page titles for Legal, Minutes, Policies, and Resolutions namespaces

Page titles should be altered with {{DISPLAYTITLE:NAME}} as needed - with inclusion of Wikimedia or Wikimedia Foundation in title as appropriate. Pages using the {{DISPLAYTITLE}} should not have their page title's marked for translation as well.

Example

<languages />
{{DISPLAYTITLE:<translate>Wikimedia Foundation Donuts Policy</translate>}}
{{policy-board}}
<translate>
== Why we have a Donuts Policy ==

Pages properly formatted to review for additional help:

Namespace placement

See also: Wikimedia:Namespaces

Whenever possible, content should be placed within these namespaces to facilitate greater searching of content.

Main namespace
General content, navigational pages, or content without a clear namespace
Talk namespaces
Discussions and archives of discussions
Wikimedia
Content related to operations of Wikimedia Foundation Governance Wiki
Policy
Wikimedia Foundation and Wikimedia Movement policies
Resolution
Resolutions by the Wikimedia Foundation Board of Trustee
Legal
Wikimedia Foundation legal documentation
Agenda
Agendas of Wikimedia Foundation Board of Trustee meetings
Minutes
Minutes of Wikimedia Foundation Board of Trustee meetings
Committee
Content related to committees of the Wikimedia Foundation Board of Trustee
Endowment
Content related to the Wikimedia Endowment
Memory
Institutional knowledge of the Wikimedia Foundation
Archive
Archived or historical content no longer in active use on this wiki and available for migration to another wiki (generally Meta-Wiki)

Usage of Resolutions namespace

Content placed within the Resolutions namespace should be resolutions which were considered by the Wikimedia Foundation Board of Trustees. The {{resolution}} template should be used at the top of resolution pages for proper formatting.

Usage of Policies namespace

Content placed within the Policies namespace should be official Wikimedia Foundation policies. The {{Policy-board}} or {{Policy-staff}} templates should be used to help with displaying information for readers.

Category placement

All content (pages, files, templates, etc.) on this wiki should be placed within a category that is a part of the Category:All category tree:

Translations

Please see the Translations manual of style within the Translations guidelines.