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

docs: language SDK page updates #2851

Merged
merged 11 commits into from
Dec 15, 2023
Merged

docs: language SDK page updates #2851

merged 11 commits into from
Dec 15, 2023

Conversation

petethepig
Copy link
Member

@petethepig petethepig commented Dec 14, 2023

addresses this #2775

Fixes: #2775

@petethepig petethepig requested review from a team as code owners December 14, 2023 18:56
@knylander-grafana knylander-grafana added the type/docs Improvements for doc docs. Used by Docs team for project management label Dec 14, 2023
@knylander-grafana
Copy link
Contributor

knylander-grafana commented Dec 14, 2023

@petethepig Do you want me to review? You have it labeled as a WIP but it wasn't marked as a draft.

docs/sources/configure-client/language-sdks/dotnet.md Outdated Show resolved Hide resolved
docs/sources/configure-client/language-sdks/go_push.md Outdated Show resolved Hide resolved
docs/sources/configure-client/language-sdks/go_push.md Outdated Show resolved Hide resolved
docs/sources/configure-client/language-sdks/java.md Outdated Show resolved Hide resolved
docs/sources/configure-client/language-sdks/nodejs.md Outdated Show resolved Hide resolved
docs/sources/configure-client/language-sdks/python.md Outdated Show resolved Hide resolved
docs/sources/configure-client/language-sdks/ruby.md Outdated Show resolved Hide resolved
docs/sources/configure-client/language-sdks/rust.md Outdated Show resolved Hide resolved
docs/sources/configure-client/language-sdks/dotnet.md Outdated Show resolved Hide resolved
docs/sources/configure-client/language-sdks/go_push.md Outdated Show resolved Hide resolved
docs/sources/configure-client/language-sdks/java.md Outdated Show resolved Hide resolved
docs/sources/configure-client/language-sdks/nodejs.md Outdated Show resolved Hide resolved
docs/sources/configure-client/language-sdks/python.md Outdated Show resolved Hide resolved
docs/sources/configure-client/language-sdks/ruby.md Outdated Show resolved Hide resolved
docs/sources/configure-client/language-sdks/rust.md Outdated Show resolved Hide resolved
@petethepig
Copy link
Member Author

@knylander-grafana sorry about the confusion. it was not ready earlier, but it is ready now

Copy link
Contributor

@knylander-grafana knylander-grafana left a comment

Choose a reason for hiding this comment

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

@petethepig Great job updating everything and making sure that things are consistent!

I have some minor changes, but one change I'd like to make across all of the page, which is why this is a change request.

Here's the change (which I'm happy to make and then remove the request changes):

I want to change the Before you begin section acrtoss all of the pages to be only these two paragraphs:

To capture and analyze profiling data, you need either a hosted Pyroscope OSS server or hosted Pryoscope instance with Grafana Cloud Profiles](/products/cloud/profiles-for-continuous-profiling/) (requires a free Grafana Cloud account).

The Pyroscope server can be a local server for development or a remote server for production use.

The rest of the information about Pyroscope and Grafana Cloud Profiles is not necessary for Before you begin. we link to Grafana Cloud Profiles and people can go read if they want to. That extra information feels out of scope for "Before you begin". None of the other doc I work on has that level of detail.

@knylander-grafana knylander-grafana self-requested a review December 15, 2023 21:58
Copy link
Contributor

@knylander-grafana knylander-grafana left a comment

Choose a reason for hiding this comment

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

Really well done work for this PR! You did a good job making everything consistent.

I went ahead and changed the Before you begin section.

@knylander-grafana knylander-grafana merged commit a031533 into main Dec 15, 2023
18 checks passed
@knylander-grafana knylander-grafana deleted the sdk-docs branch December 15, 2023 22:36
knylander-grafana added a commit that referenced this pull request Dec 15, 2023
* docs changes

* improvements

* wip

* fixes

* fixes

* fixes

* Update docs/sources/configure-client/language-sdks/go_push.md

* Update docs/sources/configure-client/language-sdks/go_push.md

* Apply suggestions from code review

* Update Before you begin sections

---------

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Kim Nylander <kim.nylander@grafana.com>
knylander-grafana added a commit that referenced this pull request Dec 16, 2023
* Changes from 2855 intro doc

* docs: update go-pull.md (#2844)

* docs: update go-pull.md

* fix links

* rm comments

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* typo

* Update docs/sources/configure-client/grafana-agent/go_pull.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

---------

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Ryan Perry <Rperry2174@gmail.com>

* Create release notes for v1.2.1 (#2860)

* docs: Add sampling documentation (#2854)

* Add sampling doc

* Tweak wording and layout

* Fix links

* Fix absolute links

* Variety of small tweaks in structure and wording

* docs: Refactor ebpf installation (#2849)

* docs: Refactor ebpf installation

* docs: Refactor ebpf installation

* Remove not useful sections.

* review feedbac

* remove absolute link to grafana.com

* lint

* review feedback

* Add diagram for ebpf

* linted

* Update docs/sources/configure-client/grafana-agent/ebpf/_index.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/_index.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/_index.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/configuration/_index.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/configuration/_index.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-docker.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-docker.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-kubernetes.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-kubernetes.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-linux.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-linux.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-linux.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/troubleshooting.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/troubleshooting.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/troubleshooting.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/troubleshooting.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-linux.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-linux.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

* Update docs/sources/configure-client/grafana-agent/ebpf/setup-kubernetes.md

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>

---------

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Ryan Perry <Rperry2174@gmail.com>

* docs: language SDK page updates (#2851)

* docs changes

* improvements

* wip

* fixes

* fixes

* fixes

* Update docs/sources/configure-client/language-sdks/go_push.md

* Update docs/sources/configure-client/language-sdks/go_push.md

* Apply suggestions from code review

* Update Before you begin sections

---------

Co-authored-by: Kim Nylander <104772500+knylander-grafana@users.noreply.github.com>
Co-authored-by: Kim Nylander <kim.nylander@grafana.com>

* doc: Add sampling diagram (#2861)

---------

Co-authored-by: Tolya Korniltsev <korniltsev.anatoly@gmail.com>
Co-authored-by: Ryan Perry <Rperry2174@gmail.com>
Co-authored-by: Bryan Huhta <32787160+bryanhuhta@users.noreply.github.com>
Co-authored-by: Cyril Tovena <cyril.tovena@gmail.com>
Co-authored-by: Dmitry Filimonov <dmitry.filimonov@grafana.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
type/docs Improvements for doc docs. Used by Docs team for project management
Projects
None yet
Development

Successfully merging this pull request may close these issues.

[DOC] [EPIC] Update the language SDK docs
3 participants