refactor segments for consistency

Author: giortzisg

docs/platforms/go/common/logs/index.mdx

@@ -11,9 +11,9 @@ With Sentry Structured Logs, you can send text based log information from your a
 
 ## Requirements
 
-Logs in Go are supported in Sentry Go SDK version `0.33.0` and above. For using integrations of other log libraries, have a look at each specific page for more details on requirements.
+Logs in Go are supported in Sentry Go SDK version `0.33.0` and above. To use integrations with other logging libraries, check their specific documentation pages for detailed requirements.
 
-## Setup
+## Configure
 
 To enable logging, you need to initialize the SDK with the `EnableLogs` option set to true.
 
@@ -25,6 +25,31 @@ sentry.Init(sentry.ClientOptions{
 })
 ```
 
+### Options
+
+#### BeforeSendLog
+
+To filter logs, or update them before they are sent to Sentry, you can use the `BeforeSendLog` client option.
+
+```go
+sentry.Init(sentry.ClientOptions{
+    Dsn:        "___PUBLIC_DSN___",
+    EnableLogs: true,
+    BeforeSendLog: func(log *sentry.Log) *sentry.Log {
+        // filter out all trace logs
+        if log.Level == sentry.LogLevelTrace {
+            return nil
+        }
+
+        // filter all logs below warning
+        if log.Severity <= sentry.LogSeverityInfo {
+            return nil
+        }
+        return log
+    },
+})
+```
+
 ## Usage
 
 Once the feature is enabled on the SDK and the SDK is initialized, you can send logs by using the `sentry.Logger` API or our different integrations.
@@ -106,31 +131,6 @@ logger := log.New(sentryLogger, "", log.LstdFlags)
 logger.Println("Implementing log.Logger")
 ```
 
-## Options
-
-### BeforeSendLog
-
-To filter logs, or update them before they are sent to Sentry, you can use the `BeforeSendLog` client option.
-
-```go
-sentry.Init(sentry.ClientOptions{
-    Dsn:        "___PUBLIC_DSN___",
-    EnableLogs: true,
-    BeforeSendLog: func(log *sentry.Log) *sentry.Log {
-        // filter out all trace logs
-        if log.Level == sentry.LogLevelTrace {
-            return nil
-        }
-
-        // filter all logs below warning
-        if log.Severity <= sentry.LogSeverityInfo {
-            return nil
-        }
-        return log
-    },
-})
-```
-
 ### Debug
 
 If the `Debug` init option is set to true, calls to the `sentry.Logger` will also print to the console with the appropriate log level.

docs/platforms/go/guides/logrus/index.mdx

@@ -11,13 +11,15 @@ Go API documentation for the [`sentrylogrus` package](https://pkg.go.dev/github.
 
 Logrus structured logging is supported in Sentry Go SDK version `0.34.0` and above.
 
-## Setup
+## Install
 
 Install the `sentrylogrus` package:
 ```bash
 go get github.com/getsentry/sentry-go/logrus
 ```
 
+## Configure
+
 To enable logging, you need to initialize the SDK with the `EnableLogs` option set to true.
 
 ```go
@@ -28,7 +30,7 @@ sentry.Init(sentry.ClientOptions{
 })
 ```
 
-## Configure
+### Options
 
 `sentrylogrus` provides two types of hooks to configure the integration with Sentry. Both hooks accept these options:
 - **Levels**: A slice of `logrus.Level` specifying which log levels to capture
@@ -117,7 +119,7 @@ func main() {
 
 ### LogHook
 
-You have two ways to create a new `LogHook`. Either by using `sentrylogrus.NewLogHook()` and passing the `sentry.ClientOptions` or
+You have two ways to create a new `LogHook`. Either by using `sentrylogrus.NewLogHook()` and passing the `sentry.ClientOptions`, or
 by using `sentrylogrus.NewLogHookFromClient()` and passing an already created `sentry.Client`. These hook captures log entries and
 send them to Sentry's structured logging system.
 
@@ -151,7 +153,7 @@ logHook := sentrylogrus.NewLogHookFromClient(
 
 ### EventHook
 
-You also have two ways to create a new `EventHook`. Either by using `sentrylogrus.NewEventHook()` and passing the `sentry.ClientOptions` or
+You also have two ways to create a new `EventHook`. Either by using `sentrylogrus.NewEventHook()` and passing the `sentry.ClientOptions`, or
 by using `sentrylogrus.NewEventFromClient()` and passing an already created `sentry.Client`. These hook captures log entries and
 send them as events. This is helpful for error tracking and alerting.
 
@@ -187,7 +189,7 @@ eventHook := sentrylogrus.NewEventHookFromClient(
     When using both hooks, ensure you flush both of them before the application exits and register exit handlers for fatal logs to avoid losing pending events.
 </Alert>
 
-## Correlating Logs with Traces
+## Correlating Logs With Traces
 
 To correlate logs with transactions, you need to pass a `context.Context` that contains transaction information to your logger calls. The `sentryhttp` middleware automatically adds transaction information to the request's context.
 Here's an example of how to use `WithContext` in an HTTP handler to ensure logs are associated with the correct trace.

docs/platforms/go/guides/slog/index.mdx

@@ -70,7 +70,7 @@ type Option struct {
 
 ## Usage
 
-To integrate Sentry with slog, you need to set up a Sentry handler and configure the Sentry client.
+To integrate Sentry with slog, you need to set up a Sentry handler and configure the Sentry client:
 
 ```go
 func main() {

includes/logs/go-ctx-usage-alert.mdx

@@ -1,4 +1,4 @@
-## Correlating Logs with Traces
+## Correlating Logs With Traces
 
 In order to properly attach the correct trace with each log entry, a `context.Context` is required.
 If you're using logs combined with tracing, you should pass the correct context to properly attach each trace with the appropriate logs.