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

Remove confusing description from Body field in Logs Data Model #3827

Merged
merged 17 commits into from Feb 6, 2024

Conversation

pellared
Copy link
Member

@pellared pellared commented Jan 16, 2024

Related to #3814

Changes

Remove confusing description from Body field in Logs Data Model.

The description makes the specification not clear as the language authors may understand that the Bridge API must only accept Body as string.

Additionally, I do not think that the following recommendation is actually a good one:

First-party Applications SHOULD use a string message

CHANGELOG.md Outdated Show resolved Hide resolved
pellared and others added 2 commits January 16, 2024 19:51
Co-authored-by: jack-berg <34418638+jack-berg@users.noreply.github.com>
@pellared
Copy link
Member Author

@tigrannajaryan PTAL

@tigrannajaryan
Copy link
Member

I agree that the removed wording does not belong to the data model and is not helpful.

However, before we remove it I want to make sure we are not breaking our Stability guarantees. It seems OK to me since I can't see how it is actionable by SDK implementors. It is more of a usage recommendation for end users and would be better suited to a non-normative document like a library guideline.

I would like @open-telemetry/specs-logs-approvers to confirm that they do not think this is a breaking change and we are not breaking our stability promise.

specification/logs/data-model.md Outdated Show resolved Hide resolved
pellared and others added 2 commits January 26, 2024 00:18
@pellared
Copy link
Member Author

I made some editorial changes. In my opinion, it is better but it may be good to double-check.

@tigrannajaryan
Copy link
Member

Please resolve the conflicts.

@pellared
Copy link
Member Author

pellared commented Feb 6, 2024

Please resolve the conflicts.

@tigrannajaryan, done.

@tigrannajaryan tigrannajaryan merged commit 7aa1793 into open-telemetry:main Feb 6, 2024
7 checks passed
@pellared pellared deleted the body-remove-unclear branch February 6, 2024 19:52
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.

None yet

10 participants