MAG:Templates

(Tasks)
(Open/Closed table, justification, and petition templates: Template requests)
Line 18: Line 18:
*** Should these templates be set up as "justification tables" to be inserted into larger articles or as individual articles?
*** Should these templates be set up as "justification tables" to be inserted into larger articles or as individual articles?
** Petition templates for requesting that a closed package be opened.
** Petition templates for requesting that a closed package be opened.
 +
** Pages maintained by Nokia and containing official information/documentation. They should have a clear notice with Nokia logo on top. It is likely that they would be editable only by a certain group, having the discussion page open for comments. This should be explained in the banner as well.--[[User:qgil|qgil]] 07:53, 28 June 2008 (UTC)
 +
** Equivalent to "This article is a stub, please help expanding it."--[[User:qgil|qgil]] 07:53, 28 June 2008 (UTC)
 +
** Equivalent to "This article is probably outdated, please help updating it."--[[User:qgil|qgil]] 07:53, 28 June 2008 (UTC)
 +
** Equivalent to "This article has poor language/grammar, please help fixing it."--[[User:qgil|qgil]] 07:53, 28 June 2008 (UTC)
 +
** Template to identify tasks? Open/Completed?--[[User:qgil|qgil]] 07:53, 28 June 2008 (UTC)
== Types of templates ==
== Types of templates ==

Revision as of 07:53, 28 June 2008

Templates are an important part of any good mediawiki wiki. They help tag, categorize, identify, stylize and format articles, and improve code readability and clarity, and generally make life easier for everybody.

To that end, I'd like to focus efforts here on creating and maintaining a set of templates for maemowiki.

Contents

Tasks

  • Develop guidelines for the creation, categorization, style and format of new templates.
    • Ensure existing templates comply with these guidelines.
  • Figure out what templates we need (this is a very fluid task that will likely never be completed).
  • Create those templates.

Open/Closed table, justification, and petition templates

We need to put together templates for the open/closed-source plan outlined in the Increasing transparency page.

  • We need templates for:
    • Individual packages (or package sets, as, say, alarmd and alarmtool can probably both be filed under alarmd), their source-state and (if closed) justification for that state.
      • Should these templates be set up as "justification tables" to be inserted into larger articles or as individual articles?
    • Petition templates for requesting that a closed package be opened.
    • Pages maintained by Nokia and containing official information/documentation. They should have a clear notice with Nokia logo on top. It is likely that they would be editable only by a certain group, having the discussion page open for comments. This should be explained in the banner as well.--qgil 07:53, 28 June 2008 (UTC)
    • Equivalent to "This article is a stub, please help expanding it."--qgil 07:53, 28 June 2008 (UTC)
    • Equivalent to "This article is probably outdated, please help updating it."--qgil 07:53, 28 June 2008 (UTC)
    • Equivalent to "This article has poor language/grammar, please help fixing it."--qgil 07:53, 28 June 2008 (UTC)
    • Template to identify tasks? Open/Completed?--qgil 07:53, 28 June 2008 (UTC)

Types of templates

There are effectively two types of templates that need to be created:

Transcluded

First, we have transcluded templates are those that help in navigation, organization, categorization, and tagging. They are designed to maintain uniform look and format across the entire wiki. These will constitute the bulk of the work. Things like,

Main article: Maemowiki Action Group

Image:Ambox_notice.png
This article is continued discussion from the maemo.org brainstorm
Please see the 100 Days agenda for more.


Substituted

Second, we have substituted templates, which are those that provide skeletal frameworks for certain types of pages. These will include things like the Close-source justification page, and open-source petition page.

For example, an early version of such a template is Template:Plan metadata (see User:jaffa/Sandbox for example usage). One thing to note is that nice, clean CSS classes like "wikitable" do not seem to be present in maemowiki at the moment.