Skip to content

GitLab

  • Menu
Projects Groups Snippets
    • Loading...
  • Help
    • Help
    • Support
    • Community forum
    • Submit feedback
    • Contribute to GitLab
  • Sign in / Register
  • ketos ketos
  • Project information
    • Project information
    • Activity
    • Labels
    • Planning hierarchy
    • Members
  • Repository
    • Repository
    • Files
    • Commits
    • Branches
    • Tags
    • Contributors
    • Graph
    • Compare
  • Issues 27
    • Issues 27
    • List
    • Boards
    • Service Desk
    • Milestones
  • Merge requests 0
    • Merge requests 0
  • CI/CD
    • CI/CD
    • Pipelines
    • Jobs
    • Schedules
  • Deployments
    • Deployments
    • Environments
    • Releases
  • Monitor
    • Monitor
    • Incidents
  • Analytics
    • Analytics
    • Value stream
    • CI/CD
    • Repository
  • Wiki
    • Wiki
  • Snippets
    • Snippets
  • Activity
  • Graph
  • Create a new issue
  • Jobs
  • Commits
  • Issue Boards
Collapse sidebar
  • public_projects
  • ketosketos
  • Wiki
  • New release instructions

Last edited by Oliver Kirsebom Oct 13, 2021
Page history

New release instructions

Release versioning convention:

  • Major version update (1.0 -> 2.0) when including significantly new functionality, where changes are not compatible with previous versions
  • Minor version update (1.0 -> 1.1) when adding new functionality that remain backwards compatible
  • Patch version update (1.0 -> 1.0.1) when adding patches that remain backwards compatible

Steps required to make a new release

  1. Merge all changes into the Development branch
  2. Make sure all unit tests and doc tests are passing successfully on the GitLab server
  3. Make sure all tutorials are working; if necessary update tutorials and copy new html files to the appropriate folder in the ketos docs section.
  4. Update the change log (docs/source/versions/changelog.rst)
  5. Update the version number in setup.py and docs/source/conf.py
  6. Commit and push changes from step 4 and 5 to the Development branch
  7. Build the documentation:
cd docs/
make html
  1. Review the documentation
  2. Create a merge request for the Development branch into the master branch
  3. Once this merge request has been reviewed and accepted, upload the new version to PyPI:
python setup.py sdist bdist_wheel
twine upload dist/ketos-X.Y.Z.tar.gz
  1. Finally, upload the documentation to the docs server:
cd docs
./upload.sh
Clone repository
  • Home
  • New release instructions
  • Sphinx Documentation guides