Skip to content

Declare freeze of Trace API Specification 1.0#1121

Merged
carlosalberto merged 9 commits intoopen-telemetry:masterfrom
tigrannajaryan:feature/tigran/freeze-trace-spec
Nov 17, 2020
Merged

Declare freeze of Trace API Specification 1.0#1121
carlosalberto merged 9 commits intoopen-telemetry:masterfrom
tigrannajaryan:feature/tigran/freeze-trace-spec

Conversation

@tigrannajaryan
Copy link
Copy Markdown
Member

@tigrannajaryan tigrannajaryan commented Oct 20, 2020

We want to freeze Trace API specification 1.0 so that we no longer accept substantial changes (unless a fundamental problem is found in the spec).

Contributes to #1120

@tigrannajaryan tigrannajaryan requested review from a team October 20, 2020 20:35
@tigrannajaryan tigrannajaryan marked this pull request as draft October 20, 2020 20:36
@Oberon00
Copy link
Copy Markdown
Member

Please make sure to keep this in ready-for-review state a long enough time and not merge it straight out of draft state.

@arminru arminru added release:required-for-ga Must be resolved before GA release, or nice to have before GA spec:trace Related to the specification/trace directory labels Oct 23, 2020
@github-actions
Copy link
Copy Markdown

This PR was marked stale due to lack of activity. It will be closed in 7 days.

@github-actions github-actions bot added the Stale label Oct 31, 2020
@tigrannajaryan tigrannajaryan force-pushed the feature/tigran/freeze-trace-spec branch from 76def07 to ce81306 Compare November 3, 2020 16:51
@tigrannajaryan tigrannajaryan marked this pull request as ready for review November 3, 2020 16:52
@tigrannajaryan
Copy link
Copy Markdown
Member Author

This is ready for review, but don't merge.

@tigrannajaryan tigrannajaryan changed the title Declare freeze of Trace Specification 1.0 [REVIEW BUT DON'T MERGE] Declare freeze of Trace Specification 1.0 Nov 3, 2020
Copy link
Copy Markdown
Member

@Oberon00 Oberon00 left a comment

Choose a reason for hiding this comment

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

The set of documents frozen does not include resources and common. I think at least common/ needs to be frozen before trace. resources/ also needs to be frozen before tracing goes GA.
EDIT: Semantic conventions are also not included which seems fine. Although maybe exception semantic conventions should be frozen, since we have record_exception referencing it from the trace API spec.

@github-actions github-actions bot removed the Stale label Nov 4, 2020
Copy link
Copy Markdown
Member

@bogdandrutu bogdandrutu left a comment

Choose a reason for hiding this comment

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

Overall LGTM, but need to make sure we close all PRs before merging this.

@tigrannajaryan tigrannajaryan force-pushed the feature/tigran/freeze-trace-spec branch from 0ca12f4 to 3de0b2a Compare November 9, 2020 17:30
@tigrannajaryan tigrannajaryan changed the title [REVIEW BUT DON'T MERGE] Declare freeze of Trace Specification 1.0 Declare freeze of Trace Specification 1.0 Nov 9, 2020
@tigrannajaryan tigrannajaryan changed the title Declare freeze of Trace Specification 1.0 Declare freeze of Trace API Specification 1.0 Nov 9, 2020
@tigrannajaryan
Copy link
Copy Markdown
Member Author

tigrannajaryan commented Nov 9, 2020

Discussed in the Maintainers meeting. For now this PR includes only Trace API, but not Trace SDK. We would like to get this merged today or tomorrow. Please review.

Copy link
Copy Markdown
Member

@andrewhsu andrewhsu left a comment

Choose a reason for hiding this comment

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

LGTM

Copy link
Copy Markdown
Member

@Oberon00 Oberon00 left a comment

Choose a reason for hiding this comment

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

I think we need to also freeze the attributes sections of common/common.md: https://github.com/open-telemetry/opentelemetry-specification/blob/master/specification/common/common.md#attributes and for that I'd like to see #1203 resolved. EDIT: And #1213.

Copy link
Copy Markdown
Member

@bogdandrutu bogdandrutu left a comment

Choose a reason for hiding this comment

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

Please also freeze the common as @Oberon00 suggested

@tigrannajaryan tigrannajaryan force-pushed the feature/tigran/freeze-trace-spec branch from 201a6a8 to 7dac4a4 Compare November 12, 2020 15:26
@tigrannajaryan
Copy link
Copy Markdown
Member Author

specification/common/common.md is now part of this freeze.

@Oberon00 Oberon00 added the area:api Cross language API specification issue label Nov 12, 2020
Tigran Najaryan and others added 7 commits November 16, 2020 11:57
@tigrannajaryan tigrannajaryan force-pushed the feature/tigran/freeze-trace-spec branch from 7dac4a4 to 4315893 Compare November 16, 2020 16:58
Co-authored-by: Armin Ruech <armin.ruech@dynatrace.com>
@tigrannajaryan
Copy link
Copy Markdown
Member Author

I think this is good to merge.

@carlosalberto
Copy link
Copy Markdown
Contributor

We got enough approvals and the last two pending issues we had were solved. Merging now!

@carlosalberto carlosalberto merged commit 82865fa into open-telemetry:master Nov 17, 2020
@tigrannajaryan tigrannajaryan deleted the feature/tigran/freeze-trace-spec branch March 19, 2021 14:18
carlosalberto pushed a commit to carlosalberto/opentelemetry-specification that referenced this pull request Oct 31, 2024
* Declare freeze of Trace Specification 1.0

We want to freeze Trace specification 1.0 so that we no longer accept substantial changes (unless a fundamental problem is found in the spec).

Resolves open-telemetry#1120
schmikei pushed a commit to schmikei/opentelemetry-specification that referenced this pull request Apr 17, 2025
* Declare freeze of Trace Specification 1.0

We want to freeze Trace specification 1.0 so that we no longer accept substantial changes (unless a fundamental problem is found in the spec).

Resolves open-telemetry#1120
schmikei pushed a commit to schmikei/opentelemetry-specification that referenced this pull request Apr 17, 2025
* Declare freeze of Trace Specification 1.0

We want to freeze Trace specification 1.0 so that we no longer accept substantial changes (unless a fundamental problem is found in the spec).

Resolves open-telemetry#1120
schmikei pushed a commit to schmikei/opentelemetry-specification that referenced this pull request Apr 17, 2025
Co-authored-by: Liudmila Molkova <limolkova@microsoft.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area:api Cross language API specification issue release:required-for-ga Must be resolved before GA release, or nice to have before GA spec:trace Related to the specification/trace directory

Projects

None yet

Development

Successfully merging this pull request may close these issues.