From c0c6e84a4916239f63d3dc6142cdd45e0e8d6af2 Mon Sep 17 00:00:00 2001
From: Aaron Weeden <31246768+aaronweeden@users.noreply.github.com>
Date: Thu, 31 Oct 2024 12:25:22 -0400
Subject: [PATCH] Release v1.0.2. (#41)

---
 CHANGELOG.md              |  7 +++++--
 README.md                 |  9 +++++++-
 docs/developing.md        | 43 +++++++++++++++++++++++++++++++--------
 setup.cfg                 |  2 +-
 xdmod_data/__version__.py |  2 +-
 5 files changed, 50 insertions(+), 13 deletions(-)

diff --git a/CHANGELOG.md b/CHANGELOG.md
index a154d432..d35bf058 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,9 +1,12 @@
 # xdmod-data Changelog
 
-## v1.x.y development branch
+## v1.0.2 (2024-10-31)
+
+This release fixes an `IOPub` error that can occur when calling
+`get_raw_data()` with `show_progress=True`.
 
 - Document Open XDMoD compatibility in changelog ([\#31](https://github.com/ubccr/xdmod-data/pull/31)).
-- Fix IOPub error when showing progress with `get_raw_data()` ([\#37](https://github.com/ubccr/xdmod-data/pull/37)).
+- Fix IOPub error when showing progress with `get_raw_data()` ([\#40](https://github.com/ubccr/xdmod-data/pull/40)).
 
 ## v1.0.1 (2024-09-27)
 
diff --git a/README.md b/README.md
index df216f20..2e9bbbbf 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,13 @@
 # xdmod-data
 As part of the Data Analytics Framework for [XDMoD](https://open.xdmod.org), this Python package provides API access to the data warehouse of instances of Open XDMoD.
 
+This documentation is for **v1.0.2**. For documentation of other versions:
+
+- [v1.0.1](https://github.com/ubccr/xdmod-data/tree/v1.0.1?tab=readme-ov-file#xdmod-data)
+- [v1.0.0](https://github.com/ubccr/xdmod-data/tree/v1.0.0?tab=readme-ov-file#xdmod-data)
+- [v2.x.y (main development branch)](https://github.com/ubccr/xdmod-data/tree/main?tab=readme-ov-file#xdmod-data)
+- [v1.x.y (development branch)](https://github.com/ubccr/xdmod-data/tree/v1.x.y?tab=readme-ov-file#xdmod-data)
+
 The package can be installed from PyPI via `pip install xdmod-data`.
 
 Existing installations can be upgraded via `pip install --upgrade xdmod-data`.
@@ -14,7 +21,7 @@ Specific versions of this package are compatible with specific versions of Open
 
 | `xdmod-data` version | Open XDMoD versions |
 | -------------------- | ------------------- |
-| 1.0.1                | 11.0.x, 10.5.x      |
+| 1.0.2, 1.0.1         | 11.0.x, 10.5.x      |
 | 1.0.0                | 10.5.x              |
 
 ## API Token Access
diff --git a/docs/developing.md b/docs/developing.md
index 991fca4c..ef322742 100644
--- a/docs/developing.md
+++ b/docs/developing.md
@@ -38,8 +38,18 @@
 ## Releasing a new version
 1. Make a new branch of `xdmod-data` and:
     1. Make sure the version number is updated in `xdmod_data/__version__.py`.
-    1. Update the Open XDMoD compatibility matrix in the `README.md`.
-    1. Update `CHANGELOG.md` to change "Main development branch" to, e.g., `v1.0.1 (2024-06-XX)`.
+    1. In `README.md`:
+        1. Under the main heading,
+            1. In the sentence that begins, `This documentation is for ...`,
+               replace the version number in bold, e.g.:
+                ```
+                This documentation is for **v1.0.2**.
+                ```
+        1. Update the Open XDMoD compatibility matrix.
+    1. Update `CHANGELOG.md` to:
+        1. Change the `development branch` to, e.g., `v1.0.1 (2024-06-XX)`.
+        1. Add a summary of the changes in the version.
+    1. In `setup.cfg`, update the `long_description` to change the version number in the URL to the new version.
     1. Create a Pull Request for the new version.
 1. After the Pull Request is approved (but not merged yet), follow these steps in a cloned copy of the branch:
     1. Start up a virtual environment, e.g.:
@@ -88,11 +98,28 @@
     1. Where it says `Attach binaries`, attach the built distribution that was uploaded to PyPI.
     1. Click `Publish release`.
     1. Go to the [GitHub milestones](https://github.com/ubccr/xdmod-data/milestones) and close the milestone for the version.
+1. If this is a minor or patch release to a version that is not the most recent major version,
+    1. For each major version above this release's major version,
+        1. Add the entry for this version to the `CHANGELOG.md`.
+        1. In the `README.md`:
+            1. Add an item to the top of the bulleted list for
+               the new version, making sure to replace the version number in
+               the link text and in the URL.
+            1. Update the Open XDMoD compatibility matrix.
 
 ## After release
-1. Make a new branch of `xdmod-data` and:
-    1. Make sure the version number is updated in `xdmod_data/__version__.py` to a pre-release of the next version, e.g., `1.0.1-01`.
-    1. Update `CHANGELOG.md` to add a section at the top called `Main development branch`.
-    1. Go to the [GitHub milestones](https://github.com/ubccr/xdmod-data/milestones) and add a milestone for the version.
-    1. Create a Pull Request for the new version.
-    1. Once the Pull Request is approved, merge it into `main`.
+
+1. In a Pull Request to the `main` branch of `xdmod-data`:
+    1. Make sure the version number is updated in `xdmod_data/__version__.py`
+       to a development pre-release of the next version, e.g., `1.0.1.dev1`.
+    1. In `README.md`, under the main heading, in the sentence that begins,
+       `This documentation is for ...`, replace the version number in bold,
+       e.g.:
+        ```
+        This documentation is for **v1.x.y (main development branch)**.
+        ```
+    1. Update `CHANGELOG.md` to add a section at the top called `v1.x.y (main
+       development branch)`, replacing `1` with the major version under
+       development.
+    1. Go to the [GitHub milestones](https://github.com/ubccr/xdmod-data/milestones)
+       and add a milestone for the version under development.
diff --git a/setup.cfg b/setup.cfg
index 5a7b303d..f87aef0f 100644
--- a/setup.cfg
+++ b/setup.cfg
@@ -4,7 +4,7 @@ version = attr: xdmod_data.__version__
 author = Aaron Weeden, Joseph P. White, Rodney Garnett
 maintainer = Aaron Weeden, Joseph P. White
 description = Python package for Open XDMoD data access
-long_description = See the [README](https://github.com/ubccr/xdmod-data?tab=readme-ov-file#xdmod-data) for instructions on use.
+long_description = See the [README](https://github.com/ubccr/xdmod-data/tree/v1.0.2?tab=readme-ov-file#xdmod-data) for instructions on use.
 long_description_content_type = text/markdown
 license_files = LICENSE
 project_urls =
diff --git a/xdmod_data/__version__.py b/xdmod_data/__version__.py
index 61b75eba..b32d7acb 100644
--- a/xdmod_data/__version__.py
+++ b/xdmod_data/__version__.py
@@ -1,2 +1,2 @@
 __title__ = 'xdmod-data'
-__version__ = '1.0.2.dev1'
+__version__ = '1.0.2'