Template:Project infrastructure

From FlightGear wiki
Jump to navigation Jump to search

SourceForge


The following template description is not displayed when the template is inserted in an article.

Goal

This is an universal template for referencing the current open source infrastructure used by the FlightGear project.

Ideally other templates this will use this template for URNs and links, so that this will be the only template that need to be changed if parts of the FlightGear infrastructure move from one host to another (for details of why, see the Background section below).

Usage

{{project infrastructure
| mode
| urn        =
| link       =
| text       =
| noprotocol =
}}
mode
The type of infrastructure. This defaults to name, but can be one of:
name
The name of the hosting infrastructure.
abbrev
An abbreviation for the hosting infrastructure, mainly for use in other templates (no link, and current returns sf).
nightlies
nightly builds
buildserver
The FlightGear build server
forum
The FlightGear forum.
scenery
The FlightGear scenery website.
website
The FlightGear website.
wiki
The FlightGear wiki.
mailing lists
The FlightGear mailing lists.
urn
The optional uniform resource name, the part of the URL after the domain name.
link
If set to yes, then a MediaWiki link will be created, when appropriate. The value of no will cause plain text to be returned. This defaults to yes.
text
The optional custom text to use for the link.
noprotocol
If set, then the protocol part of the URL will not be added. This is, for example, https://.

Examples

Name

{{project infrastructure|name}}

SourceForge

{{project infrastructure|name|link=no}}

SourceForge

{{project infrastructure|nightlies}}

Nightly builds

Abbreviation

{{project infrastructure|abbrev}}

sf

Build Server

{{project infrastructure|buildserver}}

FlightGear Build Server

Forum

{{project infrastructure|forum}}

FlightGear Forum

{{project infrastructure|forum|urn=search.php|text=Search the forum}}

Search the forum

{{project infrastructure|forum|link=no}}

https://forum.flightgear.org

site:{{project infrastructure|forum|link=no|noprotocol=yes}}

site:forum.flightgear.org

Scenery

{{project infrastructure|scenery}}

FlightGear Scenery Website

Website

{{project infrastructure|website}}

website

{{project infrastructure|website|link=no}}

http://flightgear.org

Wiki

{{project infrastructure|wiki}}

FlightGear wiki

{{project infrastructure|wiki|link=no}}

https://wiki.flightgear.org

Background

Currently all our code and data lives on SourceForge. Collecting everything from gitorious, googlecode and private servers, getting our build server work with the new locations was not a trivial task, took months to complete and was everything but a pleasant job.[1][2] However, should the project (or any of its associated websites) ever need to be moved again (a discussion that keeps coming up, and is even raised by former core developers,[3][4][5]) this template will help isolate required changes.

The creation of this template was motivated by the workload caused by the shutdown of gitorious (to become gitlab) and subsequent migration of all repositories to sourceforge.[6] Shortly afterwards, Sourceforge and Slashdot were sold, where most of the FlightGear project's infrastructure had moved at the time.[7]

The wiki admins back then realized that the workload due to having to update dozens, if not even hundreds, of articles could be greatly reduced if a common set of templates were to be used for "encapsulating" (hiding) such details. In particular, the creation of the repo link (respectively git/svn link) templates (started by Red Leader and Johan G) will greatly help isolate and reduce the amount of work needed to maintain our wiki articles up to date.

Related templates

{{project infrastructure option}}


References