docs: Add docs on building the SDK

[mydea]

As this comes up every now and then (e.g. #5108), I gather it makes sense to document how to build the SDK youself. I added a note to explicitly state that there are no guarantees there.

[anthonyryan1]

I appreciate the effort, but this still doesn't address #5108

Here's an example trying to follow your instructions:

npm exec yarn

yarn install v1.22.21
info No lockfile found.
[1/5] Validating package.json...
[2/5] Resolving packages...
error Error: https://registry.yarnpkg.com/@sentry-internal%2fintegration-shims

@sentry-internal looks like some not open source components that are a mandatory part of your build process. We are still dead in the water for people building the bundles from npm.

[mydea]

There is not npm exec yarn anywhere in the instructions, I believe? Not sure where you got this from. If you run yarn install & yarn build as documented it should work. I guess npm probably does not pick up dependencies correctly, this is an internal package that is inside of the monorepo, so that will be resolved by yarn at build time.

[anthonyryan1]

Yarn is not part of my build process, so I didn't have it installed globally I ran npm exec yarn to run yarn without installing it globally.

I installed yarn on my workstation globally though, just to match your instructions more precisely.

I can get far enough in yarn && yarn install against git master that it fails on my distro not being ubuntu and failing during @sentry-internal/browser-integration-tests, so I don't believe there's issues against the overall repository.

But the issue in #5108 is about building the code you ship onto npm that can't be used directly any longer.

ar@phenom ~/Projects/website/node_modules/@sentry/browser $ yarn
yarn install v1.22.19
info No lockfile found.
[1/5] Validating package.json...
[2/5] Resolving packages...
error An unexpected error occurred: "https://registry.yarnpkg.com/@sentry-internal%2fintegration-shims: Not found".
info If you think this is a bug, please open a bug report with the information provided in "/home/ar/Projects/website/node_modules/@sentry/browser/yarn-error.log".
info Visit https://yarnpkg.com/en/docs/cli/install for documentation about this command.

ar@phenom ~/Projects/website/node_modules/@sentry/browser $ yarn install
yarn install v1.22.19
info No lockfile found.
[1/5] Validating package.json...
[2/5] Resolving packages...
error An unexpected error occurred: "https://registry.yarnpkg.com/@sentry-internal%2fintegration-shims: Not found".
info If you think this is a bug, please open a bug report with the information provided in "/home/ar/Projects/website/node_modules/@sentry/browser/yarn-error.log".
info Visit https://yarnpkg.com/en/docs/cli/install for documentation about this command.

ar@phenom ~/Projects/website/node_modules/@sentry/browser $ yarn build
yarn run v1.22.19
error Command "build" not found.
info Visit https://yarnpkg.com/en/docs/cli/run for documentation about this command.

How do we turn the npm source into a built release that can be used in a project?

[AbhiPrasad]

Hi @anthonyryan1 - I responded to that entire thread with #5108 (comment). Any comments about the suggestions made there?