Wikimedia:Manual of style: Difference between revisions

Content deleted Content added

Inline

Revision as of 05:04, 29 March 2024

See also: Wikimedia:Editing policy

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

Try to utilize English which will not be difficult to translate into other languages
When in doubt, refer to manual of styles on Wikimedia project wikis or the "Communicating about the Wikimedia Foundation" guide on Meta-Wiki

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.

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 left for translation and altered with {{DISPLAYTITLE:NAME}} as needed - with inclusion of Wikimedia or Wikimedia Foundation in title as appropriate.

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:

All

By year

Files

Users

Wikimedia Foundation projects

@@ Line 57: / Line 57: @@
 <!--T:34-->
-Page titles should be left for translation and altered with <tvar name="1"><code><nowiki>{{DISPLAYTITLE:NAME|noerror}}</nowiki></code></tvar> as needed - with inclusion of Wikimedia or Wikimedia Foundation in title as appropriate.
+Page titles should be left for translation and 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.
 </translate>
@@ Line 63: / Line 63: @@
 <pre>
 <languages />
-{{DISPLAYTITLE:&#60;translate>Wikimedia Foundation Donuts Policy&#60;/translate>|noerror}}
+{{DISPLAYTITLE:&#60;translate>Wikimedia Foundation Donuts Policy&#60;/translate>}}
 {{policy-board}}
 &#60;translate>