Open Framework, Information Management Strategy & Collaborative Governance | Data & Social Methodology - MIKE2.0 Methodology
Wiki Home
Collapse Expand Close

Members
Collapse Expand Close

To join, please contact us.

Improve MIKE 2.0
Collapse Expand Close
Need somewhere to start? How about the most wanted pages; or the pages we know need more work; or even the stub that somebody else has started, but hasn't been able to finish. Or create a ticket for any issues you have found.

MIKE2:Contribution Process

From MIKE2.0 Methodology

Share/Save/Bookmark
Jump to: navigation, search
Open methodology framework logo.jpg
This article is a key aspect of the Open Methodology Framework and has therefore been protected. Propose changes to this article on its corresponding discussion page.

The Contribution Process for MIKE2.0 includes adding new content, getting this content reviewed by other members of the Data Governance and Management Consortium and having this content brought into the overall MIKE2.0 Methodology. Most new articles start as Supporting Assets but can eventually be used to extend the Overall Implementation Guide and Solutions.

This page details the different stages in an article's life, and lists the various ways you can help articles grow into becoming part of the overall MIKE2.0 methodology and even extend the core approach.

Whilst MIKE2.0 has adopted many of its formatting standards and approach from Wikipedia and it uses the same MediaWiki software, the approach and goals are different. It is helpful to look at a comparison between MIKE2.0 and Wikipedia to understand this better.

Every article starts with an idea in the mind of a Contributor. You can create articles about whatever you are interested in, so long as they are in the scope of the MIKE2.0 Methodology.

Contents

Before Adding New Content to MIKE2

Review the MIKE2 Methodology

There is a lot of content in MIKE2.0 and you certainly don't need to understand all of it to be a Contributor. It is beneficial, however, to have at least a high-level understanding of the overall approach and the area you are working on. Before contributing, review relevant aspects of the Overall Implementation Guide, Usage Model and relevant MIKE2.0 Solutions.

Understand the Contribution Model

Before adding any content to MIKE2.0, it is important to understand the Licensing Model. Guidelines for Contributors need to be followed throughout the process which vary by different levels within the Contribution Model.

Famaliarise yourself with MediaWiki

Get a general understanding of how MediaWiki works, especially its syntax and programming language. Make sure to understand the purpose of Talk Pages, Articles, Page History and Protected Content.

Wikipedia provides a much more thorough set of user documentation and samples, but keep in mind that not all of the functionality available in Wikipedia (e.g. templates, custom functions) are accessible in MIKE2.0.

Understand Standards and Guidelines

The Manual of Style should be used for providing guidelines on how articles should be written by providing standards on topics such as naming conventions, formatting and use of categories. These are MIKE2.0-specific Standards and Guidelines that derive largely from the approach used by the Wikipedia Manual of Style.

Adding New Content to MIKE2

New Articles

Open methodology framework logo.jpg
This article is a key aspect of the Open Methodology Framework and has therefore been protected. Propose changes to this article on its corresponding discussion page.

Any Contributor can add new articles to the MIKE2.0 Methodology. Before adding a new article, contributors should:

  • Search to see if an article already exists. You should try searching under multiple keywords and also may sure to review Stub Articles and Under Construction Articles
  • Look into similar articles to determine if it should be a standalone article or a subset of an existing article
  • Review Style Guide and Contribution Process

To add an article, simply add the article name following the main URL http://mike2.openmethodology.org/index.php/New Arcticle Name

If you search for an article and do not find one, you will also be prompted to start a new article of that page name.

Alternatively, you can use the widget below to create articles in MIKE2.0 simply by adding the new article's name.

Wanted Articles

One of the best things you can do with MIKE2.0 is to help contribute where there are identified gaps in the approach. These Wanted articles come in 3 categories:

  1. Red link articles are those articles that have been tagged but for which there is no content. Therefore, the link shows up red.
  2. Requested articles are in-demand articles for which no or very little content has been written. Generally, its better to create a Stub Article if you would like to initiate the process of writing an article. Stub Articles are a better option than Requested Articles because when you create a stub, you not put some formal structure into the article. In addition, you specifically classify your article as a stub so that others can assist in completing it.
  3. A facility exists to Internationalise MIKE2.0 and make the content available in languages other than English. Articles that have the same content but in different languages can be linked together. This model also provides the mechanism to contribute initial articles in languages other than English.

Stub Articles

Open methodology framework logo.jpg
This article is a key aspect of the Open Methodology Framework and has therefore been protected. Propose changes to this article on its corresponding discussion page.

Stub Articles are very short articles, generally of one paragraph or less. Creating Stub Articles can provide a good approach when a Contributor to MIKE2.0 has a limited amount of time or feels their knowledge of an area is incomplete. If an article cannot be completed, sometimes a placeholder tables of contents is used to show the key areas to be covered when the article is more mature.

By writing a stub, you can help other Contributors get a better understanding of what you are looking for and it will generally help facillitate the process of getting a completed article.

Key aspects you may to include in a stub include:

To intiate a discussion around known changes to the article, use the article's Talk Pages.

To identify an article as a Stub, the Stub Template should be added to the top of the Article using the following text:

{{MIKE2 Stub}}

You can help also complete articles by looking through the the inventory of stub articles.

Wikipedia also uses the concept of Stub Articles to the same ends and provides a comprehensive description of this approach.

Under Construction Arcticles

Open methodology framework logo.jpg
This article is a key aspect of the Open Methodology Framework and has therefore been protected. Propose changes to this article on its corresponding discussion page.

Under Construction Articles are articles that are still in draft form and have not yet undergone a Peer Review. A good way to help get involved with MIKE2 is to help review those articles that are Under Construction.

To identify an article as Under Construction, the Under Construction Template should be added to the top of the Article using the following text:

{{MIKE2 Under Construction}}

When the author(s) feels the article has reached a mature state, they can have it defined as being ready for a Peer Review within the article's Talk Pages.

Peer review

Open methodology framework logo.jpg
This article is a key aspect of the Open Methodology Framework and has therefore been protected. Propose changes to this article on its corresponding discussion page.

Peer Reviews are used to get feedback from fellow Contributors with the aim of improving your article. Ask your fellow Contributors for their opinions, list outstanding issues and areas to improve on Talk Pages and get other Contributors involved. Of course, it best to have a reasonably well-developed article so those giving comments have something substantial to offer feedback on.

After a thorough peer review, an article can improve to the point where it is recognised as part of the Core MIKE2.0 Methodology. Once its part of the core MIKE2.0, it is seen as a stable part of the overall approach.

Peer Review Process

Key aspects of the Peer Review process are as follows:

Initiating the Peer Review

After an article has gone through the process of being under construction and has reached a relatively mature state, its ready for a Peer Review. To identify an article as Ready for Peer Review, place the Peer Review Template in the Talk Pages of the article by adding the following text to the top of the page: {{Peer Review}}

Conduct a Discussion on the Article

Contributors should use Talk Pages to review the article and discuss proposed changes. Changes can also be made to the article in conjunction with the discussion. Discussion on Talk Pages should be focused on relevant topics around the article's improvement and how it may be incorporated into the overall MIKE2.0 Methodology.

Goals of a Peer Review

The primary goal of a Peer Review is to improve the proposed article. A Peer Review may also result in the following:

  • Recommendation that an article be included into the Core MIKE2.0 Methodology
  • Recommendation to merge the article with another article
  • Recommendation that the article be removed as it contains inappropriate content
  • Major changes to the proposed approach
  • Re-categorisation of the article

Conduct

The conduct for the Peer Review process is particularly important as it will be common to have differing points of view on the direction of an article. The following should be kept in mind:

  • Discussion and language should be kept professional
  • It is not necessary to have a single solution to a proposed approach; it is valid to list multiple options to the same proposed solution
  • Contributors should encourage reviews and expect their content to be edited

For a far more detail approach on conducting Peer Reviews, refer to the Wikipedia section of Peer Reviews. MIKE2.0 follows the same standards of conduct regards Peer Reviews and use of Talk Pages.

Recommending Extensions

A mature article that has gone through Peer Review is a candidate to add as a Core Supporting Asset or to even extend the MIKE2.0 Methodology. Candidate articles that will add detail to or change the Core MIKE2.0 Methodology are reviewed by the MIKE2.0 Leadership Team.

Articles that are determined to be of particular value and will be brought into the overall methodology will be highlighted on the main page. This provides an opportunity to showcase the contribution the author has made to the overall approach.

Other Ways to Contribute

Not all contributions involve writing new articles. Other types of valuable feedback can be given on Talk Pages, FAQs and general Community Forum discussions.

Some Supporting Assets, especially Tools and Technique Papers and Software Assets may include content that is not hosted within the MIKE2.0 wiki. All content, however, should have an article that describes it in the wiki. IM QuickScan, for example, is hosted as part of a separate web-based application but it is also described in the wiki. Users can then suggest content changes as Talk Pages to these articles.

Software Assets are not hosted on the MIKE2.0 environment but can be reviewed and referenced as part of the methodology. Each asset that is reviewed should have its own article page.

Wiki Contributors
Collapse Expand Close