Move Unity into the common Getting Started (#3414)

* move Unity into the common Getting Started

* move and rename images

* Update src/platforms/unity/unity-lite.mdx

Co-authored-by: Bruno Garcia <[email protected]>

* modify config statement in common

* Update src/platforms/unity/unity-lite.mdx

Co-authored-by: Bruno Garcia <[email protected]>

* Update src/platforms/unity/unity-lite.mdx

Co-authored-by: Bruno Garcia <[email protected]>

Co-authored-by: Bruno Garcia <[email protected]>

Author: PeloWriter

src/platforms/unity/sentry_window.png renamed to src/includes/getting-started-config/sentry_window.png

@@ -1,6 +1,19 @@
-You can attach Sentry to a Game Object and initialize it with the DSN programatically:
+Currently, you can only configure Sentry using the Unity tools window.
 
-```csharp
-var sentry = gameObject.AddComponent<SentrySdk>();
-sentry.Dsn = "___PUBLIC_DSN___";
-```
+Open `Tools` -> `Sentry`.
+
+The first time you open the window, Unity Sentry SDK related files are created:
+
+* `Assets/Resources/Sentry/SentryOptions.json` - Sentry settings
+* `Assets/Resources/Sentry/link.xml` - [a special file](https://docs.unity3d.com/Manual/ManagedCodeStripping.html) for [ILL2CPP](https://docs.unity3d.com/Manual/IL2CPP.html) builds
+
+![Sentry tools](tools_sentry.png)
+
+And the Sentry configuration window will open:
+
+![Sentry window](sentry_window.png)
+
+* Check `Enable` to enable Sentry event capturing
+* `DSN` displays the Sentry DSN value
+
+After you close the window, all settings are saved into `Assets/Resources/Sentry/SentryOptions.json`.

src/platforms/unity/tools_sentry.png renamed to src/includes/getting-started-config/tools_sentry.png

@@ -1,5 +1,10 @@
-Get the SDK via the [Unity Package Manager using a Git URL](https://docs.unity3d.com/Manual/upm-ui-giturl.html) to Sentry's SDK repository:
+Install the SDK from [`Unity UPM`](https://docs.unity3d.com/Manual/upm-ui.html) using a Git URL to Sentry's SDK repository:
 
 ```
-https://github.com/getsentry/sentry-unity-lite.git#1.0.3
+https://github.com/getsentry/unity.git#{{ packages.version('sentry.dotnet.unity', '0.0.5') }}
 ```
+<Note>
+
+Confirm there's no empty space at the end of the line. The Unity Package Manager will fail to find the package if an empty space is appended to the end of the URL.
+
+</Note>

src/includes/getting-started-config/unity.mdx

@@ -1,5 +1,7 @@
 <Note>
 
-_Pure C# 6 SDK compiled with Unity and supported by all Unity platforms._
+This is preview SDK. Features available in a preview are still in progress and may have bugs. We recognize the irony, and we'd appreciate your feedback.
+
+To use a stable version, please see our [Unity Lite content](/platforms/unity/unity-lite/).
 
 </Note>

src/includes/getting-started-install/unity.mdx

@@ -1,5 +1,53 @@
-Once the SDK is configured with the DSN, you can call from anywhere:
+Create `TestMonoBehaviour.cs` with contains `Debug.LogError` (but can be any exception like the C# expression `throw null`):
 
 ```csharp
-SentrySdk.CaptureMessage("Test event");
+using UnityEngine;
+
+public class TestMonoBehaviour : MonoBehaviour
+{
+    void Start()
+    {
+        Debug.Log("Log");
+        Debug.LogWarning("Warning");
+        Debug.LogError("Error");
+    }
+}
+```
+
+Assign it to any object you have in the scene and press play. Open up your Sentry project in the web UI and check the logs.
+
+You should see a new issue:
+
+![Sentry issue](sentry_issue.png)
+
+Open it up and check breadcrumbs:
+
+![Sentry breadcrumbs](sentry_breadcrumbs.png)
+
+The list of captured events are displayed.
+
+### Event debouncer
+
+A debouncing mechanism is in place. This means that if you try to send a many requests in a quick succession (with the same log type), we will take the first one and ignore the others given the time slot. Current settings:
+
+* `LogType.Error` (also exceptions) or `LogType.Exception` or `LogType.Assert` - one second
+* `LogType.Log` - one second
+* `LogType.Warning` - one second
+
+Create another `DebouncerTestMonoBehaviour.cs`, then assign it to any object in the scene and run it.
+
+```csharp
+using UnityEngine;
+
+public class DebouncerTestMonoBehaviour : MonoBehaviour
+{
+    void Start()
+    {
+        Debug.Log("Log");             // recorded
+        Debug.Log("Log2");            // not recorded (1 second didn't expire from the previous call)
+        Debug.LogWarning("Warning");  // recorded
+        Debug.LogWarning("Warning2"); // not recorded
+        Debug.LogError("Error");      // recorded
+    }
+}
 ```

src/includes/getting-started-primer/unity.mdx

@@ -22,8 +22,12 @@ Sentry captures data by using an SDK within your application’s runtime.
 
 ## Configure
 
+<PlatformSection notSupported={["unity"]}>
+
 Configuration should happen as early as possible in your application's lifecycle.
 
+</PlatformSection>
+
 <PlatformContent includePath="getting-started-config" />
 
 ## Verify

src/platforms/unity/sentry_breadcrumbs.png renamed to src/includes/getting-started-verify/sentry_breadcrumbs.png

@@ -4,13 +4,13 @@ description: "Unity Lite Sentry SDK."
 sidebar_order: 5
 ---
 
-<PlatformContent includePath="getting-started-primer" />
+_Unity Lite is a pure C# 6 SDK compiled with Unity and supported by all Unity platforms._
 
 On this page, we get you up and running with Sentry's SDK, so that it will automatically report errors and exceptions in your application.
 
 <Note>
 
-This is a stable but lightweight SDK which doesn't support all of Sentry's features. It's in the process of being replaced by [Unity SDK](/platforms/unity). 
+This is a stable but lightweight SDK that doesn't support all of Sentry's features. It's in the process of being replaced by [Unity SDK](/platforms/unity).
 
 </Note>
 
@@ -20,23 +20,36 @@ This is a stable but lightweight SDK which doesn't support all of Sentry's featu
 
 Sentry captures data by using an SDK within your application’s runtime.
 
-<PlatformContent includePath="getting-started-install" />
+Get the SDK via the [Unity Package Manager](https://docs.unity3d.com/Manual/upm-ui-giturl.html) using a Git URL to Sentry's SDK repository:
+
+```
+https://github.com/getsentry/sentry-unity-lite.git#1.0.3
+```
 
 ## Configure
 
 Configuration should happen as early as possible in your application's lifecycle.
 
-<PlatformContent includePath="getting-started-config" />
+You can attach Sentry to a Game Object and initialize it with the DSN programatically:
+
+```csharp
+var sentry = gameObject.AddComponent<SentrySdk>();
+sentry.Dsn = "___PUBLIC_DSN___";
+```
 
 ## Verify
 
 This snippet includes an intentional error, so you can test that everything is working as soon as you set it up:
 
-<PlatformContent includePath="getting-started-verify" />
+Once the SDK is configured with the DSN, you can call from anywhere:
+
+```csharp
+SentrySdk.CaptureMessage("Test event");
+```
 
 <Note>
 
-Learn more about manually capturing an error or message, in our <PlatformLink to="/enriching-events/breadcrumbs/">Usage documentation</PlatformLink>.
+Learn more about manually capturing an error or message, in our <PlatformLink to="/usage/">Usage documentation</PlatformLink>.
 
 </Note>