Theaninova/openstapps
1
0
Fork 0
mirror of https://gitlab.com/openstapps/openstapps.git synced 2026-01-19 08:02:55 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

docs: add workflow documentation to readme

Browse Source
This commit is contained in:
Karl-Philipp Wulfert
2018-12-03 15:06:54 +01:00
parent 7981463255
commit b277d9fd39
1 changed files with 38 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

38
README.md
View File

@@ -2,6 +2,44 @@
This repository contains documentation, project resources and cli tools to manage the `@openstapps` projects.
## Meetings
We have developer meetings via video conference on at least every first and third wednesday of the month.
An agenda is generated with the project management tool that contains all issues that have the label `meeting`.
## Integrating new schools
### Subgroup in GitLab
Every school gets their own subgroup on GitLab inside the group `@openstapps`.
The technical name is the license plate of the school. This can be found in the [list of license plates](resources/license-plates.md).
The official name of the school is used as the group's name and a matching logo is picked to act as the group's logo - this should be a square one because of the way that GitLab handles/shows logos.
#### Permissions on the group
Every school should have one maintainer on the main group. This should be someone that is involved in the development.
Inside the subgroup every school can decide on its own how to handle permissions.
### Adjusting common projects
#### `gitlab-ci.yml` in `@openstapps/backend`
Every school has their own Docker image for the backend because every school needs other plugins and configuration. This is easily accomplished with a dedicated entry in the [`.gitlab-ci-yml`](https://gitlab.tubit.tu-berlin.de/stapps/backend/blob/develop/.gitlab-ci.yml).
#### Add namespace for UUID generation
To be able to generate UUIDs for things that need to be indexed/added to the backend every schools needs a namespace in the [`@openstapps/api`](https://gitlab.com/openstapps/api). This namespace can be any random, valid UUIDv4.
#### Add subgroup's id to the scripts configuration
To use the project management tool for the new subgroup, the id of that group needs to be added to the configuration of the tool.
The groups id can be found in the settings of the group on GitLab.
## Project management tool
This is a small cli tool that helps to maintain the project(s).