Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document release procedures #725

Merged
merged 5 commits into from
Jun 10, 2021
Merged

Document release procedures #725

merged 5 commits into from
Jun 10, 2021

Conversation

pazner
Copy link
Member

@pazner pazner commented Apr 1, 2021

Add some documentation for the release procedure. For now I've added documentation for the Julia interface, @jedbrown can add notes for C, Python, and Rust.

@jedbrown jedbrown changed the title [WIP] Document release procedures Document release procedures Jun 2, 2021
@jedbrown
Copy link
Member

jedbrown commented Jun 2, 2021

Thanks for starting this. Having recently refactored the Rust crates and gone through with releasing them, here's an update to the process. We could include more testing of the packaged crates like I describe for Python.

Comments welcome, and rendered file here: https://github.com/CEED/libCEED/blob/releasing-notes/RELEASING.md

RELEASING.md Outdated Show resolved Hide resolved
* `ceed.pc.template`
* `Doxyfile`

Additionally, the release notes in `doc/sphinx/source/releasenotes.rst` should be updated. Use `git log --first-parent v0.7..` to get a sense of the pull requests that have been merged and thus might warrant emphasizing in the release notes. While doing this, gather a couple sentences for key features to highlight on [GitHub releases](https://github.com/CEED/libCEED/releases). The "Current Main" heading needs to be named for the release.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we add any reference here in updating the User Manual version? That can easily fall out of date (as it is now)

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Updated now, and here's a PR for the users manual #777

You can find the version history here.
https://zenodo.org/record/4895340

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks Jed!

RELEASING.md Outdated Show resolved Hide resolved
RELEASING.md Outdated Show resolved Hide resolved
Copy link
Member

@jeremylt jeremylt left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Co-authored-by: Jeremy L Thompson <25011573+jeremylt@users.noreply.github.com>
Co-authored-by: Will Pazner <11493037+pazner@users.noreply.github.com>
Reported-by: Valeria Barra <valeriabarra21@gmail.com>
@jeremylt jeremylt merged commit 24b742e into main Jun 10, 2021
@jeremylt jeremylt deleted the releasing-notes branch June 10, 2021 14:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants