Skip to content

Commit 0fd9f40

Browse files
committed
add CONTRIBUTING.md with some information on creating new migrations
1 parent fb07bc4 commit 0fd9f40

File tree

2 files changed

+14
-1
lines changed

2 files changed

+14
-1
lines changed

CONTRIBUTING.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# Contributing to the ClassClock API
2+
3+
4+
Here are some things that may be helpful for maintainers or contributors
5+
6+
7+
## making changes to the schema
8+
If you make changes to the DB schema, generate a new migration to allow existing users to upgrade their databases. This can be done with the command `FLASK_APP=api.py pipenv run flask db migrate -m "<message>"`. Use a short, descriptive message to describe what was changed. TO upgrade, run `FLASK_APP=api.py pipenv run flask db upgrade` to update your local db to the new schema. Don't forget to also document the changes in the changelog you made to the app and which app versions are compatible with which DB versions.
9+

README.md

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -34,4 +34,8 @@ This API has been set up to run in a docker container.
3434
The simplest way to run it is to:
3535
1. aquire the container either from a docker repository or by running `docker build . -t classclock-api` in a cloned version of this repo
3636
2. set up the environment variables you want per the above table
37-
3. use a command like `docker run -p 8000:8000 --rm -it --env-file dev.env classclock-api:latest` to run the container interactively using `dev.env` as the source of the environment variables. The app will start up on port 8000.
37+
3. use a command like `docker run -p 8000:8000 --rm -it --env-file dev.env classclock-api:latest` to run the container interactively using `dev.env` as the source of the environment variables. The app will start up on port 8000.
38+
39+
## Contributing
40+
41+
If you are interested in making changes to the ClassClock API, see the [CONTRIBUTING](./CONTRIBUTING.md) file for details on how to do so.

0 commit comments

Comments
 (0)