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

Blog post: Insights from the OpenTelemetry Docs Usability Survey #5797

Merged
merged 12 commits into from
Dec 18, 2024

Conversation

tiffany76
Copy link
Contributor

@tiffany76 tiffany76 commented Dec 14, 2024

This PR creates a blog post that analyzes the results of the recent docs usability survey conducted by the End User SIG.

Fixes #5793.

Relates to open-telemetry/sig-end-user#69.

Preview: https://deploy-preview-5797--opentelemetry.netlify.app/blog/2024/otel-docs-survey/

@tiffany76 tiffany76 added the blog label Dec 14, 2024
@tiffany76 tiffany76 requested a review from a team as a code owner December 14, 2024 04:42
@opentelemetrybot opentelemetrybot requested a review from a team December 14, 2024 04:42
Copy link
Member

@svrnm svrnm left a comment

Choose a reason for hiding this comment

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

This is a really great summary, thanks @tiffany76 !

@open-telemetry/governance-committee @open-telemetry/technical-committee
@open-telemetry/sig-end-user-approvers @open-telemetry/sig-developer-experience-approvers @open-telemetry/sig-contributor-experience-approvers you all might be interested in the preview of these results as well!

content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
Copy link
Contributor

@chalin chalin left a comment

Choose a reason for hiding this comment

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

Initial comments. After @svrnm's suggestions are addressed I'll make another pass.

The text in the images seems faded. Can that easily be corrected? If not, they can stay as is. Thanks.

content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
@opentelemetrybot opentelemetrybot requested a review from a team December 17, 2024 01:23
@tiffany76
Copy link
Contributor Author

The text in the images seems faded. Can that easily be corrected? If not, they can stay as is. Thanks.

@chalin I made the image text a little darker. Hopefully that addresses your concern. Thanks!

@chalin chalin force-pushed the docs-usability-survey branch from 9bfa4e7 to 7f98a95 Compare December 17, 2024 08:57
Copy link
Contributor

@chalin chalin left a comment

Choose a reason for hiding this comment

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

Looking good! See inline for suggested revisions. Thanks for putting this together!

content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
content/en/blog/2024/otel-docs-survey/index.md Outdated Show resolved Hide resolved
@chalin chalin force-pushed the docs-usability-survey branch from 7f98a95 to 254bc67 Compare December 17, 2024 18:17
@opentelemetrybot opentelemetrybot requested a review from a team December 17, 2024 18:17
@chalin
Copy link
Contributor

chalin commented Dec 17, 2024

All checks are passing now that this PR has been rebased (FYI).

Copy link
Contributor

@chalin chalin left a comment

Choose a reason for hiding this comment

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

Looking great! Thanks for the updates. 🚀

@opentelemetrybot opentelemetrybot requested a review from a team December 18, 2024 09:58
@chalin chalin added this pull request to the merge queue Dec 18, 2024
Merged via the queue into open-telemetry:main with commit c8e8ca9 Dec 18, 2024
17 checks passed
@tiffany76 tiffany76 deleted the docs-usability-survey branch December 19, 2024 01:57
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

New Blog Post: Insights from the OpenTelemetry Docs Usability Survey
5 participants