Versions
========

Runko uses ``major.minor`` code versioning scheme, i.e., ``1.0``, ``2.1`` etc. in its official releases.
Major versions typically introduce new features, major code refactoring, and other large changes. 
Minor versions contain smaller bug fixes and enhancements. 

See `GitHub Release History <https://github.com/natj/runko/releases>`_ for more details and a change log.


.. note::
    
    Tip of the GitHub master branch (.e., ``latest``) tracks the most recent development version of the code. To run a spesific version you have to downgrade the repository to that tag.


Version history
---------------

Upcoming:
^^^^^^^^^

* v4.1: `Ripe Kiwi <https://github.com/natj/runko/>`_ 
    * collection of bug fixes to Kiwi. 
    * Unfinished release corresponds to the latest GitHub commit. 
    * **Recommended version for standard users**
* v5.0: `Unnamed developer version <https://github.com/natj/runko/tree/dev5>`_ 
    * A major code revision.
    * Latest commits in the branch reflect the state-of-the-art. 
    * **Recommended version for developers**


Previous:
^^^^^^^^^

* v4.0: `Kiwi <https://github.com/natj/runko/tree/v4.0>`_ released in Dec 2023
* v3.1: `Ripe Mango <https://github.com/natj/runko/tree/v3.1>`_ released in Sep 2023
* v3.0: `Mango <https://github.com/natj/runko/tree/v3.0>`_ released in Feb 2021
* v2.1: `Blood Orange <https://github.com/natj/runko/tree/v2.1>`_ released in Oct 2020
* v2.0: `Orange <https://github.com/natj/runko/tree/v2.0>`_ released in Mar 2020
* v1.0: `Banana <https://github.com/natj/runko/tree/v1.0>`_ released in Aug 2019