Difference between revisions of "Template:Project Facts"

From fd.io
Jump to: navigation, search
(Undo revision 8608 by Henry Ni (talk))
 
(9 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
|-
 
|-
 
|
 
|
 +
'''Project Lead:''' {{{projectLead}}}<br>
 
'''Committers:'''<br>
 
'''Committers:'''<br>
 
{{{committers}}} <br>
 
{{{committers}}} <br>
 
'''Repository:''' {{{repo|{{#if:{{{shortname|}}}|git clone https://gerrit.fd.io/r/{{{shortname}}}|unspecified}} }}}<br>
 
'''Repository:''' {{{repo|{{#if:{{{shortname|}}}|git clone https://gerrit.fd.io/r/{{{shortname}}}|unspecified}} }}}<br>
'''Mailing List:''' {{{mailingList|{{#if:{{{shortname|}}}|[https://lists.fd.io/mailman3/lists/{{{shortname}}}-dev.lists.fd.io {{{shortname}}}<nowiki>-dev@lists.fd.io</nowiki>]|unspecified}} }}}<br>
+
'''Mailing List:''' {{{mailingList|{{#if:{{{shortname|}}}|[https://lists.fd.io/mailman/listinfo/{{{shortname}}}-dev {{{shortname}}}<nowiki>-dev@lists.fd.io</nowiki>]|unspecified}} }}}<br>
 
'''Jenkins:''' {{{jenkins|{{#if:{{{shortname|}}}|[https://jenkins.fd.io/view/{{{shortname}}}/ jenkins silo]|unspecified}} }}}<br>
 
'''Jenkins:''' {{{jenkins|{{#if:{{{shortname|}}}|[https://jenkins.fd.io/view/{{{shortname}}}/ jenkins silo]|unspecified}} }}}<br>
 
'''Gerrit Patches:''' {{{gerrit|{{#if:{{{shortname|}}}|[https://gerrit.fd.io/r/#/q/project:{{{shortname}}} code patches/reviews]|unspecified}} }}}<br>
 
'''Gerrit Patches:''' {{{gerrit|{{#if:{{{shortname|}}}|[https://gerrit.fd.io/r/#/q/project:{{{shortname}}} code patches/reviews]|unspecified}} }}}<br>
Line 24: Line 25:
 
The template supports the following fields. Optional ones are called out in ''italics'' and labeled with "(optional)". Automagically populated fields are also called out. <font color="red">''Note that field names are case sensitive.''</font>
 
The template supports the following fields. Optional ones are called out in ''italics'' and labeled with "(optional)". Automagically populated fields are also called out. <font color="red">''Note that field names are case sensitive.''</font>
  
 +
* <tt>projectLead</tt>
 
* <tt>committers</tt>
 
* <tt>committers</tt>
 
* <tt>name</tt>
 
* <tt>name</tt>

Latest revision as of 05:11, 9 November 2018

{{{name}}} Facts

Project Lead: {{{projectLead}}}
Committers:
{{{committers}}}
Repository: unspecified
Mailing List: unspecified
Jenkins: unspecified
Gerrit Patches: unspecified
Bugs: unspecified

NOTE: This template should be used only for officially approved fd.io projects.

This Project Facts template is used to give people an at-a-glance view of the core information about a project and also used to track the current projects in fd.io.

Usage

The template is designed to automagically fill out the mailing list, jenkins, gerrit patches, and bugs if you just fill in the shortname variable. The other fields need to be specified by hand. See any of the pages above for examples.

Fields

The template supports the following fields. Optional ones are called out in italics and labeled with "(optional)". Automagically populated fields are also called out. Note that field names are case sensitive.

  • projectLead
  • committers
  • name
  • shortname: automagically populates the six shown sub-fields, but you can override it by explicitly defining them as well.
    • gerrit (optional)
    • jenkins (optional)
    • repo (optional)

Categories

This template adds certain categories to pages that use it. First, it adds the "Project Main Pages" category any page. As a consequence, a list of the pages using this template can be found here: Category:Project Main Pages.

To include that list inside of another page you can use:

<DynamicPageList>
category = Project Main Pages
ordermethod = categorysortkey
order = ascending
</DynamicPageList>

Like this:


Note that indirectly adding a category to a page like this is not instantaneous in mediawiki, but will instead be processed by the job queue and then they will be marked as in the appropriate category. You can accelerate this process by performing a null edit.

Project State Categories

This template also automatically, adds the "${project state} Projects" category to the page, so we can produce a category for each project state and thus we can list them out very easily as follows:

Incubation Projects: No pages meet these criteria.

Bootstrap Projects: No pages meet these criteria.

Note: This requires that the state be spelled and capitalized consistently.