hermes landing page (#1515)

* hermes landing page

* Apply suggestions from code review

Co-Authored-By: Manoel Aranda Neto <[email protected]>

* Apply suggestions from code review

Co-Authored-By: Alberto Leal <[email protected]>

* Update src/collections/_documentation/clients/react-native/hermes.md

Co-Authored-By: Daniel Griesser <[email protected]>

* move to platforms

* add snapshot

* Update src/collections/_documentation/platforms/react-native/hermes.md

Co-Authored-By: Tien "Mimi" Nguyen <[email protected]>

* Update src/collections/_documentation/platforms/react-native/hermes.md

Co-Authored-By: Tien "Mimi" Nguyen <[email protected]>

* Update src/collections/_documentation/platforms/react-native/hermes.md

Co-Authored-By: Arpad Borsos <[email protected]>

* explain custom source maps in more detail

Co-authored-by: Daniel Griesser <[email protected]>
Co-authored-by: Manoel Aranda Neto <[email protected]>
Co-authored-by: Alberto Leal <[email protected]>
Co-authored-by: Tien "Mimi" Nguyen <[email protected]>
Co-authored-by: Arpad Borsos <[email protected]>

Author: 6 people

__tests__/__snapshots__/documentation.js.snap

@@ -374,6 +374,7 @@ Array [
   "platforms/react-native/cocoapods/index.html",
   "platforms/react-native/codepush/index.html",
   "platforms/react-native/expo/index.html",
+  "platforms/react-native/hermes/index.html",
   "platforms/react-native/index.html",
   "platforms/react-native/manual-setup/index.html",
   "platforms/react-native/ram-bundles/index.html",

src/collections/_documentation/platforms/react-native/hermes.md

@@ -0,0 +1,30 @@
+---
+title: 'Hermes'
+---
+
+Sentry added support for `react-native` builds that use the `hermes` engine, which required changes to the sentry SDK, `sentry-cli` as well as Sentry itself.
+
+Sentry customers using the SaaS product (sentry.io) will need to update the SDK, and `sentry-cli`.
+The minimum required version for the SDK is `@sentry/react-native` [SDK version `1.3.3`](https://github.com/getsentry/sentry-react-native/releases/tag/1.3.3),
+and `@sentry/cli` [version `1.5.1`](https://github.com/getsentry/sentry-cli/releases/tag/1.51.1).
+
+For Sentry open source, self-hosted users, the minimum version required is [f07352b](https://hub.docker.com/r/getsentry/sentry/tags?page=1&name=f07352b).
+
+Other than making sure you have the minimum version of the SDK, Sentry itself is all you need besides the standard integration described in the [React Native Sentry documentation]({%- link _documentation/clients/react-native/index.md -%}).
+
+## Custom SourceMaps
+
+The combination of `@sentry/react-native` and `@sentry/cli` should integrate
+correctly into the `react-native` build pipeline to find and upload the correct source map.
+
+However, care must be taken to upload the correct source map when manually bundling and building react-native apps.
+
+Building Hermes bundles is a three-step process, each of which creates a different
+source map.
+
+1. Bundling / minifying using `metro`: `index.android.bundle.packager.map`
+2. Compiling to bytecode using `hermes`: `index.android.bundle.compiler.map`
+3. Merging SourceMaps using `compose-source-maps`: `index.android.bundle.packager.map + index.android.bundle.compiler.map => index.android.bundle.map`
+
+It is important to upload the third SourceMap (`index.android.bundle.map`)
+via `sentry-cli`.

src/collections/_documentation/platforms/react-native/index.md

@@ -146,6 +146,7 @@ Since this SDK is unified, all function that are available for JavaScript are al
 -   [Source Maps for Other Platforms]({%- link _documentation/platforms/react-native/sourcemaps.md -%})
 -   [Setup With CocoaPods]({%- link _documentation/platforms/react-native/cocoapods.md -%})
 -   [Using RAM Bundles]({%- link _documentation/platforms/react-native/ram-bundles.md -%})
+-   [Hermes]({%- link _documentation/platforms/react-native/hermes.md -%})
 -   [Manual Setup]({%- link _documentation/platforms/react-native/manual-setup.md -%})
     -   [iOS]({%- link _documentation/platforms/react-native/manual-setup.md -%}#ios)
     -   [Android]({%- link _documentation/platforms/react-native/manual-setup.md -%}#android)