Skip to content
Wesley Bland edited this page Jan 19, 2016 · 50 revisions

Welcome

Welcome to the MPI Standard issues repository.

This repository is public to allow anyone to participate in the MPI Forum by viewing and contributing to issues. The associated source code for the MPI Standard however, is kept private to avoid allowing unofficial copies of the MPI Standard to be easily created (see below for how to request access to this private repository).

Working Groups

If you're looking for the homes of the various working groups involved in the MPI Forum, here's a list:

Getting Started

If you're just getting started with Git, GitHub, and/or the MPI Forum's usage of Git+GitHub, you should probably read the following wiki pages in order.

  1. Git and GitHub definitions and notation
  2. Overview of the MPI Forum's GitHub usage
  3. Initial Git setup
  4. Initial GitHub setup
  5. Access to the MPI Forum private repository
  6. Clone the main MPI standards document repo
  7. Fork the MPI Forum mpi standard repo (on GitHub)

Wesley Bland (@wesbland) and Jeff Squyres (@jsquyres) recorded an "MPI Forum Intro to Git and GitHub" Webex session on 2 Nov 2015:

  1. Link to the Webex recording (streaming || download)
  2. Link to the slides

Workflows

  • Branch Management: How the MPI Forum manages its Git branches in the mpi-forum/mpi-standard repository.

  • How to file an MPI Forum issue ("ticket"): High-level workflow for filing a GitHub issue and corresponding GitHub pull request to add/edit/delete text in an MPI document.

    • NOTE: This wiki page focuses on GitHub mechanisms. Examples of corresponding Git commands for filing a GitHub pull request are described in other wiki pages, below.
  • Working Group Guidelines: Guidelines and suggestions for how Working Groups should interact with their repo and the main MPI Forum repo.

    • NOTE: This wiki pages shows two suggested models for Working Groups. Example git commands for each of the two suggested models are described in other wiki pages, below.
  • There are three typical ways to create a GitHub pull request:

    1. Creating Simple Pull Request: The Git/GitHub process for proposing new text directly into the MPI standard repo (i.e., without going through a Working Group).
    2. Working Group Example 1: The Git/GitHub process for proposing text the first model for Working Groups (i.e., the Fault Tolerance Working Group (FTWG) repo), and then up into the main MPI Forum repo.
    3. Working Group Example 2: The Git/GitHub process for proposing text the second model for Working Groups (i.e., the Tools Working Group repo), and then up into the main MPI Forum repo.

Migration from Subversion / Trac

Clone this wiki locally