Difference between revisions of "Help:Categories for Authors"

From Xen
(Release Related: Add Xen 4.3 and 4.4 categories to list)
(Developer Team Categories)
 
(8 intermediate revisions by the same user not shown)
Line 37: Line 37:
 
|-
 
|-
 
|[[:Category:Developers]]
 
|[[:Category:Developers]]
|This document is for developers of Xen or any project hosted on Xen.org
+
|This document is for developers of Xen or any project hosted by the Xen Project. '''Please also see DEVELOPER TEAM CATEGORIES!'''
 
|-
 
|-
 
|[[:Category:Project]]
 
|[[:Category:Project]]
Line 44: Line 44:
 
|[[:Category:Community]]
 
|[[:Category:Community]]
 
|This document is a community document that doesn't fit elsewhere. It is intended for general information of Xen and the community at large
 
|This document is a community document that doesn't fit elsewhere. It is intended for general information of Xen and the community at large
  +
|}
  +
  +
=== Developer Team Categories ===
  +
{| class="sortable" style="vertical-align: top; border-collapse: collapse; border-width: 1px; border-style: solid; border-color: #000"
  +
|-
  +
|style="width: 20%;background-color:#58D3F7;"|'''Category'''
  +
|style="width: 80%;background-color:#58D3F7;"|'''When to use'''
  +
|-
  +
|[[:Category:Developers]]
  +
|This document is owned by developers of the [http://xenproject.org/developers/teams/hypervisor.html Hypervisor subproject]
  +
|-
  +
|[[:Category:XenARM]]
  +
|This document is owned by developers of the [http://xenproject.org/developers/teams/arm-hypervisor.html ARM Hypervisor subproject]. ''Note that the page usually also should contain [[:Category:Developers]]'' as the ARM port is being developed as part of the Hypervisor
  +
|-
  +
|[[:Category:Embedded and Automotive]]
  +
|This document is owned by developers of the [http://xenproject.org/developers/teams/embedded-and-automotive.html Embedded and Automotive subproject]
  +
|-
  +
|[[:Category:Mirage]]
  +
|This document is owned by developers of the [http://xenproject.org/developers/teams/mirage-os.html Mirage OS subproject].
  +
|-
  +
|[[:Category:Unikraft]]
  +
|This document is owned by developers of the [https://xenproject.org/developers/teams/unikraft Unikraft subproject].
  +
|-
  +
|[[:Category:XAPI Devel]]
  +
|This document is owned by developers of the [http://xenproject.org/developers/teams/xapi.html XAPI subproject]
  +
|-
  +
|[[:Category:PVOPS]]
  +
|This document is owned by developers of the [http://xenproject.org/developers/teams/pvops.html PVOPS subproject]
  +
|-
  +
|[[:Category:Windows PV Drivers]]
  +
|This document is owned by developers of the [http://xenproject.org/developers/teams/windows-pv-drivers.html Windows PV Drivers subproject]
 
|}
 
|}
   
Line 154: Line 185:
 
|[[:Category:Xen 4.4]]
 
|[[:Category:Xen 4.4]]
 
|This document contains articles related to Xen 4.4 features, planning, etc.
 
|This document contains articles related to Xen 4.4 features, planning, etc.
  +
|-
  +
|[[:Category:Xen 4.5]]
  +
|This document contains articles related to Xen 4.5 features, planning, etc.
  +
|-
  +
|[[:Category:Xen 4.6]]
  +
|This document contains articles related to Xen 4.6 features, planning, etc.
 
|-
 
|-
 
|[[:Category:Release Notes]]
 
|[[:Category:Release Notes]]
Line 167: Line 204:
 
|[[:Category:Development Process]]
 
|[[:Category:Development Process]]
 
|This document describes a process or technique relates to projects on Xen.org. Documents in this category are mainly relevant for developers.
 
|This document describes a process or technique relates to projects on Xen.org. Documents in this category are mainly relevant for developers.
  +
|-
  +
|[[:Category:Testing]]
  +
|This document is related to testing.
 
|-
 
|-
 
|[[:Category:Design Document]]
 
|[[:Category:Design Document]]

Latest revision as of 17:07, 14 May 2019

Navigation Categories

Icon Ambox.png Every page should choose a category from the list in this section, e.g.
[[Category:Xen]] [[Category:Developers]] [[Category:HowTo]]

Before you create a new category, please read Wiki_Community#Categories!

Technology/Project Categories

Category When to use
Category:Xen This document is related to the Xen Hypervisor project or technology. This category may be used for user, developer as well as project categories.
Category:XCP This document is related to the XCP project or technology. This category may be used for user, developer as well as project categories.
Category:PVOPS This document is related to the PVOPS project or technology, which is about upstreaming and maintining Xen support in Linux. This category may be used for user, developer as well as project categories.
Category:XenARM This document is related to the XenARM project or technology. This category may be used for user, developer as well as project categories.

Audience Categories

Category When to use
Category:Users This document is for users of Xen or any project hosted on Xen.org
Category:Beginners This document is primarily targeted at beginners. Note that this category should primarily be used together with Category:Users.
Category:Developers This document is for developers of Xen or any project hosted by the Xen Project. Please also see DEVELOPER TEAM CATEGORIES!
Category:Project This document is primarily a project document such as a roadmap, TODO list, minutes, etc. for a project hosted on Xen.org
Category:Community This document is a community document that doesn't fit elsewhere. It is intended for general information of Xen and the community at large

Developer Team Categories

Category When to use
Category:Developers This document is owned by developers of the Hypervisor subproject
Category:XenARM This document is owned by developers of the ARM Hypervisor subproject. Note that the page usually also should contain Category:Developers as the ARM port is being developed as part of the Hypervisor
Category:Embedded and Automotive This document is owned by developers of the Embedded and Automotive subproject
Category:Mirage This document is owned by developers of the Mirage OS subproject.
Category:Unikraft This document is owned by developers of the Unikraft subproject.
Category:XAPI Devel This document is owned by developers of the XAPI subproject
Category:PVOPS This document is owned by developers of the PVOPS subproject
Category:Windows PV Drivers This document is owned by developers of the Windows PV Drivers subproject

Document Type Categories

Category When to use
Category:Manual This document man pages or other official documentation.
Category:ManPage This document is a man page - a document in this category should also be in Category:Manual.
Category:Overview This document contains an Overview document for a specific topic. Overviews are typically introductory and contain definitions, trade-offs, basic concepts, etc.
Category:FAQ This document contains one or several frequently asked questions including answers
Category:HowTo This document contains a HowTo document, which usually is a short tutorial
Category:Tutorial This document contains a step-by-step tutorial for a fairly complex use-case
Category:Example This document primarily contains example configuration files, settings, scripts, etc.
Category:Compatibility This document contains a information about software - software, software - hardware and other compatibility.
Category:Index This document is largely an index to other pages.
Category:Glossary This document is a definition of a term used in the Xen community or more generally.

Categories that are useful in the certain situations

Installation Related

Category When to use
Category:Host Install Documents related to installing Xen on a host
Category:Guest Install Documents related to installing guests on Xen
Category:Host Configuration Documents related to bootloader, console and network configuration

Linux/Unix Distribution Related

Category When to use
Categories related to Linux/Unix distro (active distros)

Cloud Related

Category When to use
Category:CloudStack Documents related to CloudStack integration
Category:OpenStack Documents related to OpenStack integration

Release Related

Category When to use
Category:Xen 4.2 This document contains articles related to Xen 4.2 features, planning, etc.
Category:Xen 4.3 This document contains articles related to Xen 4.3 features, planning, etc.
Category:Xen 4.4 This document contains articles related to Xen 4.4 features, planning, etc.
Category:Xen 4.5 This document contains articles related to Xen 4.5 features, planning, etc.
Category:Xen 4.6 This document contains articles related to Xen 4.6 features, planning, etc.
Category:Release Notes This document describes Release Notes for a specifc project or product hosted on Xen.org.

Development Related

Category When to use
Category:Development Process This document describes a process or technique relates to projects on Xen.org. Documents in this category are mainly relevant for developers.
Category:Testing This document is related to testing.
Category:Design Document This category contains design documents, architecture descriptions, and so on: in short it contains documents that describe how parts of the codebase work. Documents in this category are mainly relevant for developers.
Category:OCaml This document is related to the OCaml language, in which most of XCP is implemented.

Technology Related

Category When to use
Category:Kernel Contains documents related to kernel technologies
Category:NUMA This category contains all articles related to the running (or to improving the support for doing so) of the Xen Hypervisor on NUMA architectures
Category:Performance Contains documents and benchmarks related to the performance of Xen, XCP, etc.
Category:Security Contains documents related to Xen, XCP, etc. Security
Category:VGA Contains documents related to VGA, VTd, etc.
Category:XCI Contains documents related to XCI aka the Xen Client Initiative

Community Related

Category When to use
Category:Events Contains documents related to community events
Category:GSoC Contains documents related to Google Summer of Code
Category:Wiki Management Contains documents related to managing the Xen Wiki

Categories to help manage the Wiki

Content Lifecycle

Category When to use
Category:Transient This document has a limited lifespan (e.g. it describes an event or a short-lived activity). Pages in this category should be reviewed at least annually and archived appropriately.
Category:Archived This document has been archived. More on archiving pages.

Related to Maintenance Templates

Category When to use
Action Needed Lists pages that needs deletion, refactor, review, ...
Needs formatting Lists pages that contain easy formatting fixes for a beginner
RefToExternalArticle Lists pages that are a stub for an external article
Category:Trail Lists pages with that contain a Trail template
Category:TODO Lists pages with a TODO note
Category:Warning Lists pages with that contain a Warning template