Skip to content

Conversation

@buenaflor
Copy link
Contributor

@buenaflor buenaflor commented Oct 7, 2024

Current code snippet example doesn't compile in dart

DESCRIBE YOUR PR

Tell us what you're changing and why. If your PR resolves an issue, please link it so it closes automatically.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

LEGAL BOILERPLATE

Look, I get it. The entity doing business as "Sentry" was incorporated in the State of Delaware in 2015 as Functional Software, Inc. and is gonna need some rights from me in order to utilize my contributions in this here PR. So here's the deal: I retain all rights, title and interest in and to my contributions, and by keeping this boilerplate intact I confirm that Sentry can use, modify, copy, and redistribute my contributions, under Sentry's choice of terms.

EXTRA RESOURCES

@vercel
Copy link

vercel bot commented Oct 7, 2024

The latest updates on your projects. Learn more about Vercel for Git ↗︎

Name Status Preview Comments Updated (UTC)
sentry-docs ✅ Ready (Inspect) Visit Preview 💬 Add feedback Nov 26, 2024 4:10pm
2 Skipped Deployments
Name Status Preview Comments Updated (UTC)
changelog ⬜️ Ignored (Inspect) Visit Preview Nov 26, 2024 4:10pm
develop-docs ⬜️ Ignored (Inspect) Visit Preview Nov 26, 2024 4:10pm

@codecov
Copy link

codecov bot commented Oct 7, 2024

Bundle Report

Changes will increase total bundle size by 15.21MB (107.55%) ⬆️⚠️, exceeding the configured threshold of 5%.

Bundle name Size Change
sentry-docs-server* 8.37MB 8.37MB (100%) ⬆️⚠️
sentry-docs-edge-server* 254.34kB 254.34kB (100%) ⬆️⚠️
sentry-docs-client* 6.39MB 6.39MB (100%) ⬆️⚠️
sentry-docs-server-cjs 7.58MB 201.91kB (2.74%) ⬆️
sentry-docs-edge-server-array-push 333.11kB 3 bytes (-0.0%) ⬇️
sentry-docs-client-array-push 6.44MB 6 bytes (-0.0%) ⬇️

ℹ️ *Bundle size includes cached data from a previous commit

@kahest
Copy link
Contributor

kahest commented Oct 24, 2024

@buenaflor the changes are good IMO, just a thought on taking this further - we recently streamlined the getting started pages for the other (main) mobile platforms so that it contains the most relevant steps for new setups and focuses on Install, Configure, Verify. everything else is links to subpages from within the text (as needed) and a Next Steps section at the end. do you think it makes sense to expand this PR to this format?

@buenaflor
Copy link
Contributor Author

yep makes sense, I'll adapt this

Comment on lines -94 to -111
<ConfigKey name="send-default-pii">

If this flag is enabled, certain personally identifiable information (PII) is added by active integrations. By default, no such data is sent.

<Note>

If you are using Sentry in your mobile app, read our [frequently asked questions about mobile data privacy](/security-legal-pii/security/mobile-privacy/) to assist with Apple App Store and Google Play app privacy details.

</Note>

This option is turned off by default.

If you enable this option, be sure to manually remove what you don't want to send using our features for managing [_Sensitive Data_](../../data-management/sensitive-data/).

</ConfigKey>

<ConfigKey name="server-name">

Copy link
Contributor Author

Choose a reason for hiding this comment

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

removing options that are currently not in KMP layer

@buenaflor
Copy link
Contributor Author

I updated the getting started page to focus on install, configure and verify

I've spread out the rest into separate files @kahest

Copy link
Contributor

@kahest kahest 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 great, thank you for going the proverbial extra mile to streamline the landing page even more 🙏


Don't already have an account and Sentry project established? Head over to [sentry.io](https://sentry.io/signup/), then return to this page.

### Cocoa SDK Version Compatibility Table
Copy link
Contributor

Choose a reason for hiding this comment

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

I think we discussed where to put this info, but I forgot where we landed on - did we plan to put it into the repo's README and link to it from here? or don't we need this info anymore?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

https://github.com/getsentry/sentry-kotlin-multiplatform/pull/290/files

yes, we'll add it to the gh repo as it's easier to manage there.

It's still relevant for people who do the setup without the gradle plugin

@kahest kahest requested a review from romtsn October 28, 2024 17:56
@kahest kahest requested a review from a team October 28, 2024 17:56
Copy link
Contributor

@lizokm lizokm left a comment

Choose a reason for hiding this comment

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

I have some language tweaks, otherwise it looks good. The only thing I'm wondering about is whether it makes sense to move configuration options so much further down. I guess the question is, how important are configuration options for new users versus the folders we're putting above them. In the JS SDKs we actually made the decision to move "Configurations" up b/c people thought they were pretty important... I don't have an answer, just wanted to throw the question out there :)

@getsantry
Copy link
Contributor

getsantry bot commented Nov 26, 2024

This pull request has gone three weeks without activity. In another week, I will close it.

But! If you comment or otherwise update it, I will reset the clock, and if you add the label WIP, I will leave it alone unless WIP is removed ... forever!


"A weed is but an unloved flower." ― Ella Wheeler Wilcox 🥀

@getsantry getsantry bot added the Stale label Nov 26, 2024
Co-authored-by: Liza Mock <liza.mock@sentry.io>
@getsantry getsantry bot removed the Stale label Nov 27, 2024
@buenaflor buenaflor merged commit ee0ba5d into master Nov 28, 2024
11 checks passed
@buenaflor buenaflor deleted the buenaflor-patch-1 branch November 28, 2024 11:12
@buenaflor
Copy link
Contributor Author

how important are configuration options for new users versus the folders we're putting above them

in most case they're not, this setup is supposed to install everything automatically and should rarely need a manual change of the configuration (at least that's what I hope)

@github-actions github-actions bot locked and limited conversation to collaborators Dec 14, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants