Template:Docinfo/doc

From open-support.info

Jump to: navigation, search

Contents

Function

This is a semantic template which stores some basic attributes for documentation managemet.

This template also provides visual annunciations for readers on each pages when they are required, in parallel with semantic annotations and MediaWiki categories which make document relations (e.g. authors, editors, and other support staffs) aware of its various status.

These annotations can be queried at any time with special:ask, inline queies and predefined templates such as {{docinfo/query/example1}} for users' documentation managements, translation works and page updates, etc.

Usage

{{docinfo
| master page =
| master rev  =
| master link = internal / external / interwiki
| status   = draft / effective / obsolete
| progress =
| priority =
| category =
| author =
| editor =
| support =
| lang =
| desc =
| return =
| nowarn
}}

Parameters

All parameters of this template are optional.

  • master page 
–  Primary page name or url, e.g. an original page in translation, an effective version of draft page, etc. It is similar to 'master page' parameter in Template:Docu or Template:Language, yet this parameter is not mandatory when the document is the primary one itself.
  • master rev 
–  Revision id of the primary page. This parameter causes users to keep their documents in sync with its primary page, with visual annunciation, semantic annotations and page categories to notify users when the primary page is updated.
  • master link 
–  The type of link to the primary page, avialable values internal, external and interwiki. If the value is external, the parameter "master page" is regarded as url. And if the value is external or interwiki, The parameter "master rev" is ignored.

Note: Please do not use the value "external" for a moment, because it has a potential problem to store URL value into Property:Docinfo master rev which data type is page.
Default value: internal

  • status 
–  The documentation status descriptor, available values draft, effective and obsolete.
Default value: draft if parameter "master page" specified, otherwise effective.
  • progress 
–  Arbitrary string to determin the completeness of the document.
  • priority 
–  Arbitrary string to determine the priority of the document.
  • category 
–  Category or list of categories separated with camma (,). The document will be annotated and categorised with the value.
  • author 
–  User or list of users separated with comma (,) to determine the author(s) of the document.
  • editor 
–  User or list of users separated with comma (,) to determine the editor(s) of the document.
  • support 
–  User or list of users separated with comma (,) to determine other resources involved in the document, e.g. checker(s), administrator(s), etc.
  • lang 
–  Language code which determes for what language the page is prepared. If a page is plurilingual, you may specify more than one language code seperated with comma.
Default value: en
  • desc 
–  Arbitrary text to determine the document description. The value is optional, but recommended in all documents. If the value is nothing, the document will be annotated and categorised with "No description" warning, without visual annunciation.
  • return 
–  determins parameter name which is used as return value of this template.
Default value: blank (no return value)
  • nowarn 
–  To supress visual annunciations for readers, still there is annotaions and categories to call attention to users who are involved in the document.

Examples

Demonstration pages

Query

{{#ask:[[Category:Docinfo demo pages]]
|?docinfo status = Status
|?docinfo author = Author
|?docinfo editor = Editor
|?warning        = Warning
|?description    = Description
}}


{{docinfo/query/example1|User1}}

All documents in which User1 involved:


Related templates

Related pages



Personal tools
Namespaces
Variants
Actions
Navigation
Toolbox