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

docs: Add OpenEdX Release Notes Checklist to Repo. #313

Closed
wants to merge 1 commit into from

Conversation

feoh
Copy link

@feoh feoh commented Oct 13, 2023

docs: Add OpenEdX Release Notes Checklist to Repo.

One item on the checklist is currently:
'Commit this checklist to a more durable location' - Github flavored Markdown is easy, accessible, and durable so it seems a good fit.

One item on the checklist is currently:
'Commit this checklist to a more durable location' - Github flavored Markdown
is easy, accessible, and durable so it seems a good fit.
@openedx-webhooks
Copy link

Thanks for the pull request, @feoh! Please note that it may take us up to several weeks or months to complete a review and merge your PR.

Feel free to add as much of the following information to the ticket as you can:

  • supporting documentation
  • Open edX discussion forum threads
  • timeline information ("this must be merged by XX date", and why that is)
  • partner information ("this is a course on edx.org")
  • any other information that can help Product understand the context for the PR

All technical communication about the code itself will be done via the GitHub pull request interface. As a reminder, our process documentation is here.

Please let us know once your PR is ready for our review and all tests are green.

@openedx-webhooks openedx-webhooks added the open-source-contribution PR author is not from Axim or 2U label Oct 13, 2023
Copy link
Member

@mariajgrimaldi mariajgrimaldi left a comment

Choose a reason for hiding this comment

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

A few clarifying questions from someone not involved in the release notes process 😅

Comment on lines +2 to +14
- [ ] find the date for the previous release (for Olive, this was October 11, 2022)
- [ ] find the date for the next release (for Palm, this was April xx, 2022)
- [ ] Create a wiki page for the _next_ release, on the [Open edX Release Planning](https://openedx.atlassian.net/wiki/spaces/COMM/pages/13205845) wiki page ([Redwood](https://openedx.atlassian.net/wiki/spaces/COMM/pages/3890380898/Next+Release+Redwood))
### Things to do after the release is cut
- [ ] add an appropriate TOC to the release notes
- [ ] add any items from the [Pending Release wiki page](https://openedx.atlassian.net/wiki/spaces/COMM/pages/3726802953/Pending+Release+Quince)
- [ ] Review and incorporate any feature posts from [edX Partner announcements](https://partners.edx.org/announcements)
- [ ] Review and incorporate any feature posts from the [open edX blog](https://open.edx.org/category/blog/)
- [ ] Review commit messages from relevant repos. [Dinghy](https://github.com/nedbat/dinghy) seems like a useful tool for this. I used this config [olive-dinghy.yaml](https://gist.github.com/pdpinch/a1749421cc2af23f9d9a2335e065489b)
- [ ] Review [DEPR tickets ](https://openedx.atlassian.net/secure/RapidBoard.jspa?rapidView=452)
- [ ] Diff the technical documentation and build a list of links to both new and removed settings.
### Meta tasks
- [ ] Review and update this checklist
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
- [ ] find the date for the previous release (for Olive, this was October 11, 2022)
- [ ] find the date for the next release (for Palm, this was April xx, 2022)
- [ ] Create a wiki page for the _next_ release, on the [Open edX Release Planning](https://openedx.atlassian.net/wiki/spaces/COMM/pages/13205845) wiki page ([Redwood](https://openedx.atlassian.net/wiki/spaces/COMM/pages/3890380898/Next+Release+Redwood))
### Things to do after the release is cut
- [ ] add an appropriate TOC to the release notes
- [ ] add any items from the [Pending Release wiki page](https://openedx.atlassian.net/wiki/spaces/COMM/pages/3726802953/Pending+Release+Quince)
- [ ] Review and incorporate any feature posts from [edX Partner announcements](https://partners.edx.org/announcements)
- [ ] Review and incorporate any feature posts from the [open edX blog](https://open.edx.org/category/blog/)
- [ ] Review commit messages from relevant repos. [Dinghy](https://github.com/nedbat/dinghy) seems like a useful tool for this. I used this config [olive-dinghy.yaml](https://gist.github.com/pdpinch/a1749421cc2af23f9d9a2335e065489b)
- [ ] Review [DEPR tickets ](https://openedx.atlassian.net/secure/RapidBoard.jspa?rapidView=452)
- [ ] Diff the technical documentation and build a list of links to both new and removed settings.
### Meta tasks
- [ ] Review and update this checklist
- [ ] find the date for the previous release (for Olive, this was October 11, 2022)
- [ ] find the date for the next release (for Palm, this was April xx, 2022)
- [ ] Create a wiki page for the _next_ release, on the [Open edX Release Planning](https://openedx.atlassian.net/wiki/spaces/COMM/pages/13205845) wiki page ([Redwood](https://openedx.atlassian.net/wiki/spaces/COMM/pages/3890380898/Next+Release+Redwood))
### Things to do after the release is cut
- [ ] Add an appropriate TOC to the release notes
- [ ] Add any items from the [Pending Release wiki page](https://openedx.atlassian.net/wiki/spaces/COMM/pages/3726802953/Pending+Release+Quince)
- [ ] Review and incorporate any feature posts from [edX Partner announcements](https://partners.edx.org/announcements)
- [ ] Review and incorporate any feature posts from the [Open edX blog](https://openedx.org/category/blog/)
- [ ] Review commit messages from relevant repos. [Dinghy](https://github.com/nedbat/dinghy) seems like a useful tool for this. I used this config [olive-dinghy.yaml](https://gist.github.com/pdpinch/a1749421cc2af23f9d9a2335e065489b)
- [ ] Review [DEPR tickets ](https://openedx.atlassian.net/secure/RapidBoard.jspa?rapidView=452)
- [ ] Diff the technical documentation and build a list of links to both new and removed settings.
### Meta tasks
- [ ] Review and update this checklist

Comment on lines +2 to +3
- [ ] find the date for the previous release (for Olive, this was October 11, 2022)
- [ ] find the date for the next release (for Palm, this was April xx, 2022)
Copy link
Member

Choose a reason for hiding this comment

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

how is this information used?

- [ ] find the date for the next release (for Palm, this was April xx, 2022)
- [ ] Create a wiki page for the _next_ release, on the [Open edX Release Planning](https://openedx.atlassian.net/wiki/spaces/COMM/pages/13205845) wiki page ([Redwood](https://openedx.atlassian.net/wiki/spaces/COMM/pages/3890380898/Next+Release+Redwood))
### Things to do after the release is cut
- [ ] add an appropriate TOC to the release notes
Copy link
Member

Choose a reason for hiding this comment

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

what's TOC?

- [ ] add any items from the [Pending Release wiki page](https://openedx.atlassian.net/wiki/spaces/COMM/pages/3726802953/Pending+Release+Quince)
- [ ] Review and incorporate any feature posts from [edX Partner announcements](https://partners.edx.org/announcements)
- [ ] Review and incorporate any feature posts from the [open edX blog](https://open.edx.org/category/blog/)
- [ ] Review commit messages from relevant repos. [Dinghy](https://github.com/nedbat/dinghy) seems like a useful tool for this. I used this config [olive-dinghy.yaml](https://gist.github.com/pdpinch/a1749421cc2af23f9d9a2335e065489b)
Copy link
Member

Choose a reason for hiding this comment

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

what should we do with the commit messages?

@feoh
Copy link
Author

feoh commented Nov 1, 2023

Hi there! As per feedback from the community, this is moving to a page on OpenEdX Confluence.

Please add all questions and comments to that page, and thanks for your patience all! Closing this.

@feoh feoh closed this Nov 1, 2023
@openedx-webhooks
Copy link

@feoh Even though your pull request wasn’t merged, please take a moment to answer a two question survey so we can improve your experience in the future.

1 similar comment
@openedx-webhooks
Copy link

@feoh Even though your pull request wasn’t merged, please take a moment to answer a two question survey so we can improve your experience in the future.

@feoh feoh deleted the cpatti_add_release_notes_checklist branch November 1, 2023 21:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
open-source-contribution PR author is not from Axim or 2U
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

3 participants