TU-Wien-dataLAB / Grader-Service

Grader Service offers lecturers and students a well integrated teaching environment for data science, machine learning and programming classes.
https://grader-service.readthedocs.io/en/latest/
BSD 3-Clause "New" or "Revised" License
27 stars 2 forks source link

Semantic versioning plan & move toward stable release #159

Closed adammccartney closed 6 months ago

adammccartney commented 7 months ago

Description

The project contains three libraries (grader service, grader convert, and grader lab extension). Each library relies on the other two, yet the version numbers diverge:

package  version number
grader lab extension  0.2.12
grader service  0.2.8
grader convert  0.2.3

Furthermore, we then bundle these three libraries into a top level "application" called grader service that gets installed with the a helm chart, again with it's own seemingly unrelated version number.

## A chart can be either an 'application' or a 'library' chart.
#
...
appVersion: "0.2.7"

This makes it extremely difficult to create any sort of coherent release plan.

We are essentially operating in a beta release cycle at the moment and not adhering to semantic versioning.

Proposed soluition

Assume that we eventually want our software to be used by humans. Work towards a stable version 1.0.0, (even if we never get there it might be a useful to observe our code from the perspective of a human being trying to use it).