Skip to content

Commit 19c39ac

Browse files
committed
Add initial contributing guidelines
1 parent 7059a4d commit 19c39ac

2 files changed

Lines changed: 38 additions & 18 deletions

File tree

CONTRIBUTING.md

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
# Contribution Guidelines
2+
Here are some guidelines for contributing to Ilmomasiina. As the name suggests, these are not strict rules.
3+
4+
## Creating issues
5+
Issues are great for tracking suggestions, bug reports and other stuff.
6+
1. Head to [issues](https://github.com/athenekilta/ilmomasiina/issues) and click `New issue`.
7+
1. Write a clear title, that gives an idea what your issue is all about. Example: `Suggestion: Add contribution guidelines` or `Event description sometimes overflows`.
8+
1. Write a descriptive comment about the bug/feature/idea you have.
9+
1. Add a screenshot of the issue/idea, if applicable.
10+
1. If you have an idea how this could be solved, you can add it to the description.
11+
12+
## Adding commits
13+
1. If you have write access to this repository, you can create a new branch directly to this repo. Otherwise, you should fork the repository.
14+
1. Change files, commit (see below), push
15+
1. When the change is ready for review, create a pull request
16+
1. Add a reviewer or two - the CTO of Athene is always a good choice (see [https://athene.fi/hallinto/toimihenkilot/](https://athene.fi/hallinto/toimihenkilot/))
17+
1. Add descriptive comment: what is changed and why. A screenshot of change is not a bad idea.
18+
1. Create your pull request :tada:
19+
20+
## Commits and commit messages
21+
### When to commit
22+
Aim to commit only one change at a time, and to include the one change completely in one commit.
23+
### How to write great commit messages
24+
The first line is the subject line. Use imperative tense and try to summarize the change in 50 characters (at most). Subject starts with a capital letter and does not end with a period. Sometimes the subject is not enough, then you should add one blank line after the subject line and write freely about the change, preferably what has been changed and why. Also, include any issues that are related to this commit.
25+
#### Example
26+
```
27+
Add Ubuntu related instructions
28+
29+
Previously setup instructions were MacOS specific, this commit adds Ubuntu related instuctions (mysql setup is different).
30+
31+
Fixes #1337
32+
```
33+
34+
## Code style
35+
TODO

README.md

Lines changed: 3 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -22,21 +22,7 @@ Ilmomasiina is Athene's event registration system.
2222
- npm `^5.6.0`
2323
- MySQL `^8.0`
2424

25-
These are automatically installed when you use the Docker container.
26-
27-
## Using Docker container
28-
In project root directory
29-
```bash
30-
docker-compose up
31-
```
32-
This should build and run the environment so that it is accesible at [localhost:3000](http://localhost:3000). You will need to create an `.env` file in project root (see [ENV.md](ENV.md)).
33-
34-
### Create fake data
35-
Use `docker exec ilmomasiina_backend_1 npm run create-fake-data` to create some data to dockerized Ilmomasiina. The server does not like an empty database, so this is a really good idea to do when first starting the server.
36-
37-
## MySQL Setup
38-
Only follow this if you don't use the Docker container.
39-
25+
## MYSQL Setup
4026
### Mac
4127
1. Install `mysql` (8.x) with Homebrew (https://gist.github.com/nrollr/3f57fc15ded7dddddcc4e82fe137b58e)
4228
2. Start the mysql service with `brew services start mysql`
@@ -55,7 +41,6 @@ Only follow this if you don't use the Docker container.
5541
7. Follow Mac instructions step 6
5642

5743
## Getting started
58-
If you are using the Docker container, only follow step 1 as rest are automatically executed.
5944

6045
1. Create an `.env` file at the root of the project. For the contents of the .env file, check [ENV.MD](./ENV.MD)
6146
2. `npm install`
@@ -64,7 +49,7 @@ If you are using the Docker container, only follow step 1 as rest are automatica
6449
**Optional**: You can create mockup data for development by running `npm run create-fake-data`. During development, database can be resetted with `npm run reset-db`.
6550

6651
### Troubleshooting (Ubuntu)
67-
If `npm start` gives error `Error: You must provide a 'secret' in your authentication configuration`, it probably means that the `.env` file is not loaded correctly. A quick fix for this is to run `source .env`.
52+
If `npm start` gives error `Error: You must provide a 'secret' in your authentication configuration`, it probably means that the `.env` file is not loaded correctly. A quick fix for this is to either use `export VARIABLE=value` for all the variables.
6853

6954
## Mailgun setup
7055

@@ -133,4 +118,4 @@ See docs folder.
133118

134119
## Contributing
135120

136-
All help is appreciated. Please contact a fellow committer first.
121+
All help is appreciated. Please contact a fellow committer first and see [CONTRIBUTING.md](CONTRIBUTING.md).

0 commit comments

Comments
 (0)