1
1
mirror of https://github.com/theoludwig/theoludwig.git synced 2024-11-14 00:03:12 +01:00
.profile/CONTRIBUTING.md

72 lines
1.9 KiB
Markdown
Raw Permalink Normal View History

2021-04-18 01:56:23 +02:00
# 💡 Contributing
Thanks a lot for your interest in contributing to **theoludwig.fr**! 🎉
2021-04-18 01:56:23 +02:00
2023-05-13 19:09:54 +02:00
## Code of Conduct
**theoludwig.fr** adopted the [Contributor Covenant](https://www.contributor-covenant.org/) as its Code of Conduct, and we expect project participants to adhere to it. Please read [the full text](./CODE_OF_CONDUCT.md) so that you can understand what actions will and will not be tolerated.
2023-05-13 19:09:54 +02:00
2021-04-18 01:56:23 +02:00
## Types of contributions
- Reporting a bug.
- Suggest a new feature idea.
- Correct spelling errors, improvements or additions to documentation files (README, CONTRIBUTING...).
- Improve structure/format/performance/refactor/tests of the code.
## Pull Requests
- **Please first discuss** the change you wish to make via [issue](https://github.com/Divlo/Divlo/issues) before making a change. It might avoid a waste of your time.
2021-12-04 15:52:51 +01:00
- Ensure your code respect linting.
2021-04-18 01:56:23 +02:00
- Make sure your **code passes the tests**.
If you're adding new features to **theoludwig.fr**, please include tests.
2021-04-18 01:56:23 +02:00
## Commits
2023-05-13 19:09:54 +02:00
The commit message guidelines adheres to [Conventional Commits](https://www.conventionalcommits.org/) and [Semantic Versioning](https://semver.org/) for releases.
## Getting Started
2021-04-20 05:18:03 +02:00
[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/Divlo/Divlo)
2021-06-13 01:53:13 +02:00
### Prerequisites
- [Node.js](https://nodejs.org/) >= 16.0.0
- [npm](https://www.npmjs.com/) >= 8.0.0
2021-06-13 01:53:13 +02:00
### Installation
```sh
# Clone the repository
git clone https://github.com/Divlo/Divlo.git
# Go to the project root
cd Divlo
# Configure environment variables
cp .env.example .env
2021-06-13 01:53:13 +02:00
# Install
npm install
```
### Local Development environment
```sh
# Run website
2021-06-13 01:53:13 +02:00
npm run dev
```
2021-06-13 01:53:13 +02:00
### Production environment with [Docker](https://www.docker.com/)
```sh
# Setup and run all the services for you
2022-05-03 10:05:11 +02:00
docker compose up --build
```
### Services started
- `website`: <http://127.0.0.1:3000>