This is my bare minimum repo used as a template.
-
Add the minimal must-have configuration files.
-
Set the
master(ormain) branch name in the.github/workflows/pre-commit-check.yaml. -
Add your code.
-
Provide description and introductory section to the
README.mdfile. -
Read the manual and edit the
.github/CODEOWNERSfile. -
Use the
.gitignoreproperly -- do not add your IDE-specific files! -
If not yet installed, set the
.github/commit-message.templateas commit message template. Copy it to some place in your$HOMEdirectory (recommended is~/.config/git/templates/) and execute the command:git config --global commit.template <path-to-copied-template>Unlike the name,
--globalmeans user ;-). To install system-wide use--system. -
Remove this section ;-)
-
Fork a
feature/*orbug/*branch from themaster. -
Avoid doing too much in a single branch. Things unrelated to the current task must be in separate branches and pull requests.
-
For every commit, provide a comment describing what has been done and why.
-
Test your work locally before opening a pull request.
-
Open a pull request. Provide a detailed description giving hints to reviewers on:
- what they are going to review;
- what was before and why these changes are needed;
- maybe a description of some subtle implementation details;
- anything else that can help reviewers understand your idea and spend less time on review.
-
Rebase to
masterperformed by the PR assigner when review passed. -
Your feature/fix will appear in the next release.