diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS new file mode 100644 index 0000000..5d1d67e --- /dev/null +++ b/.github/CODEOWNERS @@ -0,0 +1,5 @@ +# @DecisiveAI/reviewers will be the default owners for +# everything in the repo. Unless a later match takes +# precedence, reviewers team will be requested for review +# when someone opens a pull request. +* @DecisiveAI/reviewers diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 0000000..ec05b60 --- /dev/null +++ b/.github/PULL_REQUEST_TEMPLATE.md @@ -0,0 +1,69 @@ + + +## Description + + +- ENG- + +## What type of PR is this? (only check one) + + +- [ ] Feature (`feat`) +- [ ] Bug Fix (`fix`) +- [ ] Refactor (`refactor`) +- [ ] Documentation Update (`doc`) +- [ ] Other, please specify: + +### Does this PR introduce any breaking changes? +- [ ] No +- [ ] Yes, and this is why: +- [ ] I need help determining if there are any breaking changes + +### Does the PR title type prefix match the selected type? +- [ ] Yes +- [ ] No, and this is why: +- [ ] I need help select the right one + +## Added/updated tests? +_Please keep the code coverage percentage at 80% and above._ +- [ ] Yes +- [ ] No, and this is why: +- [ ] I need help with writing tests + +## Added/updated documentation and/or lab? + +- [ ] Yes +- [ ] N/A +- [ ] I need help \ No newline at end of file diff --git a/README.md b/README.md index 320d1ae..3046d1e 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,87 @@ -# changelogs -Changelogs for MyDecisive components +# Changelogs + +This repository contains guidelines, templates, configurations, etc for MDAI that will help us format everything properly so that our changelog generator will function as expected. In addition to that, this repository will also contain the changelog that outlines changes across different MDAI components that makes up an release. + +### Table of Contents +- [Guidelines](#guidelines) + - [Pull Request Format](#pull-request-format) + - [Pull Request Title](#pull-request-title) + - [Type](#type) + - [[Optional] Scope](#optional-scope) + - [Breaking Changes Indicator](#breaking-changes-indicator) + - [Subject](#subject) + - [Example](#examples) + - [Pull Request Description](#pull-request-description) + +# Guidelines + +## Pull Request Format + +Changes can only be `Squashed & Merged` to `main` of any repositories of MDAI via a pull request. The pull request must follow the format outlined in this section to both give reviewer an easier time to understand context of the pull request and also to ensure our changelog generator can parse the changes properly. + +### Pull Request Title + +Title of a pull request must follow the [conventional commit](https://www.conventionalcommits.org/en/v1.0.0/) format (without optional body and footer), meaning the title must following the following structure: + +
+<type>(<optional scope>): <subject> ++ +#### Type + +Must be one of the following: + +- `feat`: Add or change a feature +- `fix`: Fixes issue with the codebase (e.g., bug, business logic error, typo, etc) + - `security`: A type of fixes that resolve security concerns + - `style`: A type of fixes address code style (e.g., white-space, formatting, missing semi-colons, etc) and do not affect application behavior +- `doc`: Documentation only changes +- `refactor`: Rewrite or restructure code without altering behavior + - `perf`: A type of refactor that specifically improves performance +- `test`: Adding missing tests or correcting existing tests +- `revert`: Reverts a previous commit + - *Note: For revert type, `