improve GitLab instructions in CONTRIBUTING.md
EDIT: Please see this post by Aaron, too.
We currently omit GitLab instructions, leaving it to outside documentation about using GitLab mostly. It would be nice to have clearer links to introductory or other relevant docs. If there is some GitLab "postcard" howto we could use for contributors, great: all their doc I've seen are way too lengthy. What we want is to assure that these processes are clear:
- Create an "Issue"
- Create a Merge Request
- Communicate with an authorized individual, like Aaron, to create a "Todo" and assign it to someone.
When writing the new instructions, please bear in mind the two critical aspects:
We want the ability to track progress, so please mention
- Open vs. Closed, when to close, etc.
- the "WIP:" tag for MRs
- Overview --> Activity (in left pane)
- Repository --> Charts (also in left pane)
It's important to know who something is assigned to, if at all. So please mention assignees for MRs, Issues and Todos.
Also, it may be worth mentioning that the functions of GitLab Issues can sometimes be redundant with those of MRs. If you can quickly make a proposal yourself, the MR facilitates what an Issue would. Issues are for if you don't have time to do it now and don't want to forget or if you don't know who the Issue should be assigned to.
EDIT: Also mention that if a commit fixes an issue, "Fixes #[number]" should be in the commit message.