Skip to content

Commit

Permalink
und - Updated contribution guidelines
Browse files Browse the repository at this point in the history
---

Type: und
Breaking: False
Doc Required: False
Backport Required: False
Part: 1/1
  • Loading branch information
AptiviCEO committed Aug 31, 2024
1 parent 524e1b1 commit 93ae7aa
Showing 1 changed file with 36 additions and 3 deletions.
39 changes: 36 additions & 3 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# Contributing guidelines
# Contribution guidelines

First of all, thank you for contributing to our project! This kind of act is the most welcome act to help us keep running our projects the way we want them to run. All your contributions are valuable, but you need to follow these simple rules to get your contribution accepted.

Expand Down Expand Up @@ -146,8 +146,6 @@ We follow this conventional Git commit scheme:
```
Type - Attributes - Summary
Extended Summary
---
Description
Expand Down Expand Up @@ -203,6 +201,41 @@ Take note that if you've set a commit that is a backport, make sure that the typ
* `ptp`: for prototyping
* `brk`: for breaking changes

## Releases

When planning for a new version, always start the development of the next version by changing the version found in all the relevant files (usually `Directory.Build.props` for C# projects) before starting to push commits that add new features and everything else. When development finishes, before the release tag can be pushed, the `CHANGES` file should be changed to reflect the new release, as long as it follows this convention:

```
Long description of the release
### Changes
This release contains a variety of changes, including, but not limited to:
- `[+]` Added X
- `[*]` Improved Y
- `[-]` Removed Z
Review the commit history if you want to get a deep insight about the changes.
### Feedback?
If you have issues with this version, report to us by [making a new issue ticket](https://github.com/Aptivi/PROJECT/issues/new).
```

Also, the `CHANGES.TITLE` file should be changed to match the version whose development finished but tag not pushed, as long as it follows this format:

```
[servicing] PROJECT v1.0.0: Release Name
```

The type at the beginning is necessary as it can tell us and the users in what stage this release belongs to. Currently, this list of releases should be used:

* `alpha`: Indicates that this release is an alpha version
* `beta`: Indicates that this release is a beta version
* `release`: Indicates that this release is a major release (i.e. changes the major part and/or the minor part)
* `servicing`: Indicates that this release is a minore release (i.e. changes the build part and/or the patch part)

## Assistance of AI

Although artifical intelligence (AI) is a next-gen technology that every company are leaning to, which we are proud of, but when contributing code or other things to this project, we rely on human work to ensure maximum quality. This means that you are not allowed to use any kind of AI assistance to generate code and non-code contributions, such as ChatGPT and others, in fear of licensing issues, potential security issues, and current hallucination issues. Any usage of such tools when contributing will be immediately rejected.
Expand Down

0 comments on commit 93ae7aa

Please sign in to comment.