Added changelog and build notes

Author: coretl

CHANGELOG.rst

@@ -0,0 +1,66 @@
+Changelog
+=========
+
+All notable changes to this project will be documented in this file.
+
+The format is based on `Keep a Changelog <https://keepachangelog.com/en/1.0.0/>`_,
+and this project adheres to `Semantic Versioning <https://semver.org/spec/v2.0.0.html>`_.
+
+Unreleased_
+-----------
+
+Nothing yet
+
+
+3.0_ - 2021-07-05
+-----------------
+
+Added:
+
+- More documentation #14
+
+Fixed:
+
+- Mbbi/o specifying alarm values bug introduced in 3.0b2 #15
+
+
+3.0b2_ - 2021-06-28
+-------------------
+
+Changed:
+
+- Restructured the docs #9 #10
+
+Removed:
+
+- Option of specifying scalar value for mbbi and mbbo records
+
+
+3.0b1_ - 2021-06-28
+-------------------
+
+Port to being a Python package #5
+
+Changed:
+
+- Removed ability to build as an EPICS module
+- Restructure C code as Python extension
+- Make devIocStats a submodule
+- Now has a hard dependency on epicscorelibs
+
+Added:
+
+- asyncio support
+
+
+2-16_ - 2019-12-10
+------------------
+
+Last release as an EPICS module rather than a Python package
+
+
+.. _Unreleased: https://github.com/dls-controls/pythonIoc/compare/3.0...HEAD
+.. _3.0: https://github.com/dls-controls/pythonIoc/compare/3.0b2...3.0
+.. _3.0b2: https://github.com/dls-controls/pythonIoc/compare/3.0b1...3.0b2
+.. _3.0b1: https://github.com/dls-controls/pythonIoc/compare/2-16...3.0b1
+.. _2-16: https://github.com/dls-controls/pythonIoc/releases/tag/2-16

CONTRIBUTING.rst

@@ -63,12 +63,15 @@ You can build the docs from the project directory by running::
     $ firefox build/html/index.html
 
 
-Release Checklist
------------------
+Release Process
+---------------
 
-Before a new release, please go through the following checklist:
+To make a new release, please go through the following checklist:
 
 - Choose a new PEP440 compliant release number
 - Git tag the version with a message summarizing the changes
 - Push to github and the actions will make a release on pypi
-- Push to internal gitlab and do a dls-release.py of the tag
+- Push to internal gitlab but do not release from there
+- Run ``dls-py3 download-one-dependency softioc <release>``
+- Run ``cp Pipfile.lock /dls_sw/work/python3/RHEL7-x86_64/distributions/softioc-<release>.Pipfile.lock``
+- Run ``dls-release.py -a python3ext softioc <release>``

docs/index.rst

@@ -77,6 +77,7 @@ Table Of Contents
     :maxdepth: 1
 
     reference/api
+    reference/changelog
     reference/contributing
 
 * :ref:`genindex`

docs/reference/changelog.rst

@@ -0,0 +1 @@
+.. include:: ../../CHANGELOG.rst