Skip to content

8270 release notes#8284

Merged
kcondon merged 20 commits intodevelopfrom
8270-release-notes
Dec 9, 2021
Merged

8270 release notes#8284
kcondon merged 20 commits intodevelopfrom
8270-release-notes

Conversation

@djbrooke
Copy link
Contributor

@djbrooke djbrooke commented Dec 7, 2021

What this PR does / why we need it:

The release notes for 5.9!

Which issue(s) this PR closes:

Closes #8270

Special notes for your reviewer:

Suggestions on how to test this:

Does this PR introduce a user interface change? If mockups are available, please link/include them here:

Is there a release notes update needed for this change?:

Additional documentation:

- `service payara stop`
- `service payara start`

6\. Kick off full reindex
Copy link
Contributor

Choose a reason for hiding this comment

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

Dumb Don question: why are we re-indexing?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@donsizemore - this was the note that I had:

A full re-index is needed to update the facets, as well as optionally running the "redetect file type" API on existing GeoJSON files.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@donsizemore I'll close this out for now but let me know if there are other questions

Copy link
Contributor

Choose a reason for hiding this comment

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

Ok, so it was from the GeoJSON mime type PR - but there’s zero reason to force it on everybody.
It sounds like it should be part of the "Additional Release Steps". "Step 1. - if you have any GeoJSON files misidentified as "type unknown", re-detect them following ... and then run full re-index, to update the type facets, etc."

Copy link
Member

@pdurbin pdurbin left a comment

Choose a reason for hiding this comment

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

Looks good. I left a couple minor comments.

@djbrooke djbrooke added this to the 5.9 milestone Dec 7, 2021
@djbrooke djbrooke self-assigned this Dec 7, 2021
@djbrooke djbrooke removed their assignment Dec 7, 2021
@djbrooke
Copy link
Contributor Author

djbrooke commented Dec 7, 2021

Thanks @pdurbin @donsizemore for the feedback!

@qqmyers I added the analytics fix information. Feel free to edit/comment.

@sekmiller sekmiller removed their assignment Dec 8, 2021

Please note that the Auxiliary files feature is experimental and is designed to support integration with tools from the [OpenDP Project](https://opendp.org). If the API endpoints are not needed they can be blocked.

## Major Use Cases and Infrastructure Enhancements
Copy link
Contributor

Choose a reason for hiding this comment

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

I don't want to make or request changes at the very last moment that are essentially about changing our process/the established structure of these notes. But this just feels wrong, to have long, verbose descriptions of some new features, under "Release Highlits"; but then follow up with brief, concise mentions of the same features in the "Major use cases" section...
It should really be the other way around; a brief, skinny list first; then the verbose section - ?
Maybe even: 1) skinny section; 2) upgrade instruction; and only then, "if you're still reading" - the detailed descriptions for those few who have the attention span for such things - ?
(once again, I don't want to change this note, for this release)

Copy link
Contributor

@landreev landreev left a comment

Choose a reason for hiding this comment

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

Aside from the few suggested edits, I'm happy with it.
We do need to consider changing the format of these notes, or at least rearranging the order in which we present the information, to make them more readable.
Maybe start with providing a link up top, "skip directly to the upgrade instructions ..."

@kcondon kcondon self-assigned this Dec 9, 2021
@kcondon kcondon merged commit ad75522 into develop Dec 9, 2021
@kcondon kcondon deleted the 8270-release-notes branch December 9, 2021 14:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5.9 Release Notes

6 participants