Impact Analysis Procedure
Last updated
iSHARE Change Management
Last updated
This document describes how impact analysis is considered a collaborative effort within the iSHARE Change Management process and how this is implemented using Gitlab.
After an RFC has been discussed in the Change Advisory Board and approved by the Change Manager, work on impact analysis can start. The RFC is given an RFC number by the Change Manager and moved on the from "RFC Identified" to "RFC Impact Analysis" (or given the corresponding labels).
If you are familiar with using Gitlab: the general approach is to fork the project, commit to the fork and then do a merge request to the upstream repository. In the steps below, this procedure is explained.
Make sure you have a Gitlab account and login into Gitlab
Go to the projects
Click on "Fork" (upper right) to fork the project
Execute the steps and create your fork
Use one of the the following methods for editing. After editing you need to commit changes to you fork. This can be considered as saving. In order to prevent conflicts, it's advisable to choose one of the following methods and stick to it.
Using a local IDE (for instance Visual Studio Code). This requires a local install of Git and some knowledge of Git. Commit using your local Git (or as integrated in the IDE).
When you are done editing and committing your contribution to the RFC impact analysis, you can request the Change Manager to review and accept your changes. This is done by doing a Gitlab merge request (in Github this is called a pull request).
Open your fork on Gitlab.com
In the menu, under "Code", click on "Merge requests"
Click on the button "New merge request"
Make sure that: -- On the left side under Source branch your fork is selected, with the branche you have been working on (usually "main") -- On the right side under Target branche ishare-foundation/cab/rfc, branch main is selected
Click "Compare branches and continue"
Describe the changes you have made using the title and description
Click on "Create merge request"
The changes you have made are then propsoed to the Change Manager and integrated in the RFC if they are accepted.
When writing an RFC, please conform to the following rules:
Using the online IDE provided by Gitlab. shows where to open the online IDE. After editing commit your changes as shown in .
For small changes, consider editing the single file. shows how to edit a single file. After you are done editing, press the Commit button to save your changes.
All documents regarding an RFC should be stored in a subfolder in named RFC###, where ### is the number of the RFC that was assigned to the RFC by the change manager
Write the RFC by copying the to the RFC folder, renaming it to index.md
