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

[Demo] Add info about React Native app #5704

Draft
wants to merge 6 commits into
base: main
Choose a base branch
from

Conversation

jpmunz
Copy link

@jpmunz jpmunz commented Nov 28, 2024

This updates the demo documentation to include the React Native example app that is being added here: open-telemetry/opentelemetry-demo#1781

Keeping in Draft for now as we should hold merging this until those changes are accepted

Preview: https://deploy-preview-5704--opentelemetry.netlify.app/docs/demo/services/react-native-app/

@opentelemetrybot opentelemetrybot requested a review from a team November 28, 2024 15:30
registering trace context propagators, and registering auto-instrumentation of
network requests.

[Instrumentation source](https://github.com/open-telemetry/opentelemetry-demo/blob/main/src/reactnativeapp/hooks/useTracer.ts)
Copy link
Author

Choose a reason for hiding this comment

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

modelled from the Browser Instrumentation section in content/en/docs/demo/services/frontend.md, in that file a code snippet is included directly but given the TODOs in https://github.com/open-telemetry/opentelemetry-demo/blob/b4dc87ebeac93353106ebdbc7d29eb402e49eca8/src/reactnativeapp/hooks/useTracer.ts I thought it might be better to link out here instead, thoughts?

Copy link
Member

Choose a reason for hiding this comment

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

Personally I don't like doc pages that link to code snippets.
But this is my opinion, I'd love to hear what the @open-telemetry/docs-approvers have to say.

Copy link
Member

Choose a reason for hiding this comment

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

Yes, let's not link out, especially to blob/main which may break at some point because the file was renamed.

Let's have it like on the other pages and keep the source code, we (docs and demo maintainers) can discuss if we can make use of code-excerpts (See https://github.com/open-telemetry/opentelemetry.io/tree/main/tools) for demo source code as well to keep them in sync

Copy link
Author

Choose a reason for hiding this comment

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

sounds good, updated here to include the snippet: e41e5ea

content/en/docs/demo/_index.md Outdated Show resolved Hide resolved
content/en/docs/demo/services/reactnativeapp.md Outdated Show resolved Hide resolved
registering trace context propagators, and registering auto-instrumentation of
network requests.

[Instrumentation source](https://github.com/open-telemetry/opentelemetry-demo/blob/main/src/reactnativeapp/hooks/useTracer.ts)
Copy link
Member

Choose a reason for hiding this comment

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

Personally I don't like doc pages that link to code snippets.
But this is my opinion, I'd love to hear what the @open-telemetry/docs-approvers have to say.

@opentelemetrybot opentelemetrybot requested a review from a team December 2, 2024 14:11
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.

thanks, looks good overall, a few comments

content/en/docs/demo/services/reactnativeapp.md Outdated Show resolved Hide resolved
registering trace context propagators, and registering auto-instrumentation of
network requests.

[Instrumentation source](https://github.com/open-telemetry/opentelemetry-demo/blob/main/src/reactnativeapp/hooks/useTracer.ts)
Copy link
Member

Choose a reason for hiding this comment

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

Yes, let's not link out, especially to blob/main which may break at some point because the file was renamed.

Let's have it like on the other pages and keep the source code, we (docs and demo maintainers) can discuss if we can make use of code-excerpts (See https://github.com/open-telemetry/opentelemetry.io/tree/main/tools) for demo source code as well to keep them in sync

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.

As a general comment, I don't think that the app should be documented as a part of the demo/services. Even the entry in the index page reads, "React Native mobile application that provides a UI on top of the shopping services."

How does it relate to the Collector?

Maybe we need a new Demo top-level entry?

@chalin chalin changed the title Demo docs update for the react native example app [Demo] Add info about React Native app Dec 17, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
Status: No status
Development

Successfully merging this pull request may close these issues.

4 participants