[meta] Upcoming changes to the New Platform

[joshdover]

Interested in following along? Hit the subscribe button on the right side to get email updates.

Upcoming Breaking Changes

While we stabilize the New Platform, there will be a need to break APIs in order to support new features or ease migrations. Below is a list of known breaking changes and which release they are expected to land.

7.5

• Refactor OverlayService to not require React ([new-platform] Refactor OverlayService to not require React to use #37894)
• Refactor NotificationsService Toasts to not accept React components (Refactor NotificationsService to not accept React components #36425)

TBD

• Change which custom request headers are allowed with ES clients (Scope-able elasticsearch clients #39430)
• Change name of dist environment parameter (Env contains distributable flag #40361 (comment))
• Do not use Boom errors in Elasticsearch client (Migrate authentication subsystem to the new platform.  #39446 (comment))
• Do not use Boom errors in SO client (Do not wrap SO errors in Boom #72441)
• Remove legacy elasticsearch-js client interface in favour of the new one introduced in Use new elasticsearch-js client in Elasticsearch service #35508
• Make SavedObjects client API consistent across client and server-side (client {savedObjects: [...]} server: {saved_objects: [...]})

In public API

• Refactor naming format of the config settings in kibana.yml file (will done by Operations team, but we will have to update out code Settings should use snake_case #7444)
• Strict domain separation in kibana.yml file [New Platform] 8.0 Refactor kibana.yml #46705
• Deprecate & remove elasticsearch.logQueries setting Provide substitution for elasticsearch.logQueries in the new logging config #57546
• Deprecate & remove the legacy logging system config Deprecate legacy logging configuration in favour of new logging system #82431
• Remove deprecated server.xsrf.whitelist setting Allow disabling xsrf protection per an endpoint #58717
• Remove deprecated settings https://github.com/elastic/kibana/blob/master/src/core/server/config/deprecation/core_deprecations.ts
• Remove dashboard import/export API Remove Dashboard Import/Export API #41439
• Change saved objects HTTP API to follow snake_case naming convention Use snake case for saved objects import/export API #54123

In experimental API

• Formalize HTTP error response format. instead of Boom specific { error: string, message: string, statusCode: string }. Evaluate The Problem Details for HTTP APIs RFC Formalize HTTP error response format #57296
• Remove callAsInternalUser in favour of system indices Elasticsearch client Core should expose a dedicated Elasticsearch client for interacting with Kibana system indices #82716
• Introduce synchronous config API Core should provide a synchronous API for reading config values #82723
• Deprecate and remove async lifecycles [Core] Deprecate async lifecycles #53268

Additional Information

• If you're interested in the fine-grained detail of what the Platform Team is working on, follow our team project
• For more information about the New Platform project, see this issue.
• To view documentation and guides on migrating existing plugins to the new system, see our documentation

[elasticmachine]

Pinging @elastic/kibana-platform

[joshdover]

We have moved these comms to email.

[lukeelmers]

Closing as this is pretty outdated at this point -- @mshustov feel free to re-open if you had a reason you wanted to keep track of this.

[mshustov]

I'm okay closing it. I will create separate issues for items that don't have ones.