Versioning: Difference between revisions

From Open Source Ecology
Jump to navigation Jump to search
No edit summary
No edit summary
Line 7: Line 7:
Notes:
Notes:


#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.
#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.
#When developing at the Module level, include the full name that identifies the largest unit of organization: for example: use 3D Printer Extruder v19.10, not Extruder v19.10. Same for part - use the 3D Printer Extruder Nozzle v19.10, not Nozzle v19.10.
#Use official naming convention of modules from [[GVCS Modules List]].
#Use official naming convention of modules from [[GVCS Modules List]].
#In name, use capital letters for all first letters of words in the name. Thus, it's 3D Printer, not 3D printer.
#In name, use capital letters for all first letters of words in the name. Thus, it's 3D Printer, not 3D printer.

Revision as of 22:18, 23 September 2019

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. When developing at the Module level, include the full name that identifies the largest unit of organization: for example: use 3D Printer Extruder v19.10, not Extruder v19.10. Same for part - use the 3D Printer Extruder Nozzle v19.10, not Nozzle v19.10.
  3. Use official naming convention of modules from GVCS Modules List.
  4. In name, use capital letters for all first letters of words in the name. Thus, it's 3D Printer, not 3D printer.
  5. Use v in small letters, which is short for version
  6. Since we go through multiple prototypes over multiple years - start with the year in the version name.
  7. 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.
  8. 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)