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] Adds the 8.0.0-rc1 release notes #120806

Merged
merged 13 commits into from
Jan 11, 2022

Conversation

KOTungseth
Copy link
Contributor

@KOTungseth KOTungseth commented Dec 8, 2021

Summary

Adds the release notes for 8.0.0-rc1.

@KOTungseth KOTungseth added Team:Docs v8.0.0 release_note:skip Skip the PR/issue when compiling release notes labels Dec 8, 2021
@KOTungseth KOTungseth self-assigned this Dec 8, 2021
@elasticmachine
Copy link
Contributor

Pinging @elastic/kibana-docs (Team:Docs)

docs/CHANGELOG.asciidoc Outdated Show resolved Hide resolved
docs/CHANGELOG.asciidoc Outdated Show resolved Hide resolved
[%collapsible]
====
*Details* +
Unknown saved objects types now cause {kib} migrations to fail. For more information, refer to {kibana-pull}118300[#118300].
Copy link
Member

Choose a reason for hiding this comment

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

I'm not sure if this should be "saved objects types" or "saved object types". The latter sounds more correct to me, but I don't know what the rules are 🙂

Copy link
Member

Choose a reason for hiding this comment

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

Also, instead of that PR, I think we should instead link to this issue, which contains much more context on the change: #107678

The PR has very little info; most of the discussion that would be relevant to users is in the issue.

docs/CHANGELOG.asciidoc Outdated Show resolved Hide resolved
Copy link
Contributor

@jportner jportner left a comment

Choose a reason for hiding this comment

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

I have one suggested addition below!

docs/CHANGELOG.asciidoc Show resolved Hide resolved
[%collapsible]
====
*Details* +
To make sure all Fleet API GET resposes return `items`, the following have been updated:
Copy link
Contributor

Choose a reason for hiding this comment

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

This description doesn't really capture everything that has changed (as described in the impact section). Plus I don't see any detail about /api/fleet/agents in under "impact." It feels like the "Details" section is too specific and the "Impact" section is incomplete.

Maybe someone on the dev team should clarify based on what we want to highlight for users. I don't think I'm the person to make this call.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@dedemorton can you add someone from the Dev team to review?

Copy link
Contributor

Choose a reason for hiding this comment

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

I think @juliaElastic is probably the best person to comment since they opened #119494.

Copy link
Contributor

Choose a reason for hiding this comment

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

@dedemorton hi, is the CHANGELOG generated from somewhere or are you expecting me to suggest how to update it?

Copy link
Contributor

Choose a reason for hiding this comment

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

@juliaElastic I think these entries begin in the changelog, but get edited and formatted by the Kibana writers. You should suggest changes if you think (as I do) that this section needs more work.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

@dedemorton @juliaElastic I need to merge these release notes in preparation for the release tomorrow. Please feel free to open a separate PR for any changes you want to make, and let me know if you need any help.

Copy link
Contributor

Choose a reason for hiding this comment

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

@dedemorton
So to summarize:
Changes in Fleet API for consistency, previous versions are still working, and deprecated.

  1. Rename hyphens to undescores:
  • /api/fleet/enrollment-api-keys
  • /api/fleet/agent-status
  • /api/fleet/service-tokens
  1. Change packages endpoint to split pkgkey path parameter:
  • /epm/packages/{pkgkey} to /epm/packages/{packageName}/{version}
  1. Rename response or list to items in response properties:
  • /api/fleet/enrollment_api_keys
  • /api/fleet/agents
  • /epm/packages/
  • /epm/categories
  • /epm/packages/_bulk
  • /epm/packages/limited
  • POST and DELETE /epm/packages/{packageName}/{version}
  1. Rename response to item in response properties:
  • GET and PUT /epm/packages/{packageName}/{version}

docs/CHANGELOG.asciidoc Outdated Show resolved Hide resolved
docs/CHANGELOG.asciidoc Outdated Show resolved Hide resolved
docs/CHANGELOG.asciidoc Outdated Show resolved Hide resolved
docs/CHANGELOG.asciidoc Outdated Show resolved Hide resolved
docs/CHANGELOG.asciidoc Outdated Show resolved Hide resolved
docs/CHANGELOG.asciidoc Outdated Show resolved Hide resolved
KOTungseth and others added 6 commits January 11, 2022 11:18
Co-authored-by: Lisa Cawley <lcawley@elastic.co>
Co-authored-by: Lisa Cawley <lcawley@elastic.co>
Co-authored-by: Lisa Cawley <lcawley@elastic.co>
Co-authored-by: Lisa Cawley <lcawley@elastic.co>
@kibana-ci
Copy link
Collaborator

💚 Build Succeeded

History

To update your PR or re-run it, just comment with:
@elasticmachine merge upstream

cc @KOTungseth

@KOTungseth KOTungseth merged commit 5433b56 into elastic:main Jan 11, 2022
@KOTungseth KOTungseth deleted the docs/8.0.0-rc1-rn branch January 11, 2022 22:45
@KOTungseth
Copy link
Contributor Author

💚 All backports created successfully

Status Branch Result
8.0

Note: Successful backport PRs will be merged automatically after passing CI.

Questions ?

Please refer to the Backport tool documentation

KOTungseth added a commit to KOTungseth/kibana that referenced this pull request Jan 11, 2022
* [DOCS] Adds the 8.0.0-rc1 release notes

* Additions

* Apply suggestions from code review

* Update docs/CHANGELOG.asciidoc

Co-authored-by: Joe Portner <5295965+jportner@users.noreply.github.com>

* Review comments

* Update docs/CHANGELOG.asciidoc

Co-authored-by: Lisa Cawley <lcawley@elastic.co>

* Update docs/CHANGELOG.asciidoc

Co-authored-by: Lisa Cawley <lcawley@elastic.co>

* Update docs/CHANGELOG.asciidoc

Co-authored-by: Lisa Cawley <lcawley@elastic.co>

* Update docs/CHANGELOG.asciidoc

Co-authored-by: Lisa Cawley <lcawley@elastic.co>

* Review comments pt 2

Co-authored-by: Brandon Morelli <bmorelli25@gmail.com>
Co-authored-by: Joe Portner <5295965+jportner@users.noreply.github.com>
Co-authored-by: Lisa Cawley <lcawley@elastic.co>
(cherry picked from commit 5433b56)
KOTungseth added a commit that referenced this pull request Jan 11, 2022
* [DOCS] Adds the 8.0.0-rc1 release notes

* Additions

* Apply suggestions from code review

* Update docs/CHANGELOG.asciidoc

Co-authored-by: Joe Portner <5295965+jportner@users.noreply.github.com>

* Review comments

* Update docs/CHANGELOG.asciidoc

Co-authored-by: Lisa Cawley <lcawley@elastic.co>

* Update docs/CHANGELOG.asciidoc

Co-authored-by: Lisa Cawley <lcawley@elastic.co>

* Update docs/CHANGELOG.asciidoc

Co-authored-by: Lisa Cawley <lcawley@elastic.co>

* Update docs/CHANGELOG.asciidoc

Co-authored-by: Lisa Cawley <lcawley@elastic.co>

* Review comments pt 2

Co-authored-by: Brandon Morelli <bmorelli25@gmail.com>
Co-authored-by: Joe Portner <5295965+jportner@users.noreply.github.com>
Co-authored-by: Lisa Cawley <lcawley@elastic.co>
(cherry picked from commit 5433b56)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
release_note:skip Skip the PR/issue when compiling release notes Team:Docs v8.0.0
Projects
None yet
Development

Successfully merging this pull request may close these issues.

10 participants