This repository contains organization-wide guidelines on the processes within Kowainik.
We can be contacted by email firstname.lastname@example.org.
Version control system🔗
Git version control system based on GitHub is used.
Issues and branches🔗
- Work should be done under corresponding GitHub issue. If such issue doesn’t exist: create it.
- Always discuss work under corresponding GitHub issue before doing this issue. If you see multiple ways to do something — discuss with somebody under issue comments section how to do this. If you’re not sure that there’s only one way to do the thing — discuss with somebody under issue comments section how to do this. In perfect case scenario each issue should contain some plan how to do this issue.
- The main branch should be stable, always compilable and working.
- Do your work for some issue under separate branch checkout from the main branch.
- Name your branch as
username/issueId-short-description. For example:
- You shouldn’t fix multiple issues in a single branch.
- Use this guide for commit messages.
- Every meaningful commit should contain issue number in square brackets before message.
[#6] Describe basic guidelines
Fix the typo
[skip ci]tag to the end of the commit.
Change README.md [skip ci]
- Open PR if you:
- Finished your work on the issue
- Want to share work with others (for example you can open PR if you need somebody to look and to get advice for continue working on it)
wiplabel to your PR if work is not finished.
- Add issue number at the title of PR in square brackets (just like in commit messages).
- Request review from at least two people in team.
- Pull request can be merged to the main branch only if there’re two approvals for this PR.
- Resolve all conflicts using only
git rebasecommand to make history clean.
- If you’re the second person who approves the PR you should click on the
Squash and Mergebutton.
- You can use locally
stackas your main build tool. But it’s desired to support both of them on CI.
- Every project should contain the following files in addition to code:
.github/workflows/ci.yml(GitHub Actions CI)
- Use PVP versioning for projects.