docs: Add Go Transports section

__tests__/__snapshots__/documentation.js.snap

@@ -283,6 +283,7 @@ Array [
  "platforms/go/martini/index.html",
  "platforms/go/migration/index.html",
  "platforms/go/negroni/index.html",
+ "platforms/go/transports/index.html",
  "platforms/index.html",
  "platforms/javascript/advance-settings/index.html",
  "platforms/javascript/angular/index.html",

src/collections/_documentation/platforms/go/index.md

@@ -76,6 +76,7 @@ For more detailed information about how to get the most out of `sentry-go` there
 - [Configuration]({%- link _documentation/platforms/go/config.md -%})
 - [Error Reporting]({%- link _documentation/error-reporting/quickstart.md -%}?platform={{ include.platform }})
 - [Enriching Error Data]({%- link _documentation/enriching-error-data/context.md -%}?platform={{ include.platform }})
+- [Transports]({%- link _documentation/platforms/go/transports.md -%})
 - [Integrations]({%- link _documentation/platforms/go/integrations.md -%})
  - [net/http]({%- link _documentation/platforms/go/http.md -%})
  - [echo]({%- link _documentation/platforms/go/echo.md -%})

src/collections/_documentation/platforms/go/integrations.md

@@ -1,6 +1,6 @@
 ---
 title: Integrations
-sidebar_order: 3
+sidebar_order: 4
 ---
 
 The sentry-go package currently comes with an integration for the native `net/http` package, `echo`, `gin`, `iris`, `martini` and `negroni` to make it easy to handle common scenarios.

src/collections/_documentation/platforms/go/transports.md

@@ -0,0 +1,58 @@
+---
+title: Transports
+sidebar_order: 3
+---
+
+Transports let you change the way, in which events are delivered to Sentry.
+
+The Sentry Go SDK itself, provides two built-in transports. `HTTPTransport`, which is non-blocking and is used by default. And `HTTPSyncTransport` which is blocking. Each transport, provide slightly different configuration options.
+
+## Usage
+
+To configure transport, provide an instance of `sentry.Transport` interface to `ClientOptions`
+
+```go
+package main
+
+import (
+ "time"
+
+ "github.com/getsentry/sentry-go"
+)
+
+func main() {
+ sentrySyncTransport := sentry.NewHTTPSyncTransport()
+ sentrySyncTransport.Timeout = time.Second * 3
+
+ sentry.Init(sentry.ClientOptions{
+ Dsn: "___DSN___",
+ Transport: sentrySyncTransport,
+ })
+}
+```
+
+Each transport, provide it's own factory function. `NewHTTPTransport` and `NewHTTPSyncTransport` respectively.
+
+## Options
+
+## HTTPTransport
+
+```go
+// HTTPTransport is a default implementation of `Transport` interface used by `Client`.
+type HTTPTransport struct {
+ // Size of the transport buffer. Defaults to 30.
+ BufferSize int
+ // HTTP Client request timeout. Defaults to 30 seconds.
+ Timeout time.Duration
+}
+```
+
+## HTTPSyncTransport
+
+```go
+// HTTPSyncTransport is an implementation of `Transport` interface which blocks after each captured event.
+type HTTPSyncTransport struct {
+ // HTTP Client request timeout. Defaults to 30 seconds.
+ Timeout time.Duration
+}
+```