You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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).
Copy file name to clipboardExpand all lines: README.md
+3-18Lines changed: 3 additions & 18 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -22,21 +22,7 @@ Ilmomasiina is Athene's event registration system.
22
22
- npm `^5.6.0`
23
23
- MySQL `^8.0`
24
24
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
40
26
### Mac
41
27
1. Install `mysql` (8.x) with Homebrew (https://gist.github.com/nrollr/3f57fc15ded7dddddcc4e82fe137b58e)
42
28
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.
55
41
7. Follow Mac instructions step 6
56
42
57
43
## Getting started
58
-
If you are using the Docker container, only follow step 1 as rest are automatically executed.
59
44
60
45
1. Create an `.env` file at the root of the project. For the contents of the .env file, check [ENV.MD](./ENV.MD)
61
46
2.`npm install`
@@ -64,7 +49,7 @@ If you are using the Docker container, only follow step 1 as rest are automatica
64
49
**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`.
65
50
66
51
### 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.
68
53
69
54
## Mailgun setup
70
55
@@ -133,4 +118,4 @@ See docs folder.
133
118
134
119
## Contributing
135
120
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