Versioning

From Open Source Ecology
Revision as of 22:16, 23 September 2019 by Marcin (talk | contribs)
Jump to navigation Jump to search

Versioning practice at OSE follows the naming convention of naming the module under development followed by v for version and date. Example:

3D_Printer_v19.10

This refers to the 3D Printer, the version whose start build date was October of 2019.

Notes:

  1. Use a version at every level - Machine, module, or submodule/part. Note that these different levels of detail are all considered as modules when referring to the development process: you can be developing the final product at the machine level, at the module level, or sub/part level. Each of these modules should have a version.
  2. Use official naming convention of modules from GVCS Modules List.
  3. In name, use capital letters for all first letters of words in the name. Thus, it's 3D Printer, not 3D printer.
  4. Use v in small letters, which is short for version
  5. Since we go through multiple prototypes over multiple years - start with the year in the version name.
  6. Use month for the month the projects was STARTED. Since documentation is realtime and you don't know when the version development will end - it makes sense to use the month started.
  7. If multiple versions are iterated in the same month, name the latter one with the DAY it was started, such as v19.10.22 (for starting on October 22)