Skip to content

trace: changing interfaces will break backwards compability #3277

@katiehockman

Description

@katiehockman

The documentation for several of the interfaces have an addendum stating:

Warning: methods may be added to this interface in minor releases.

This is not a backwards compatible change to make per the language requirements, and any new methods added to an interface would be a breaking change for anyone who is implementing it. See the "Working With Interfaces" section of https://go.dev/blog/module-compatibility for more details about why this is a breaking change and what should be done instead should future changes be necessary.

Given that this package is a v1 API, it should be considered stable, and these kinds of breaking changes can no longer be expected in minor releases (since it's not a v0 API anymore), and those lines in the documentation should be removed.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't working

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions