docs(session): clarify manual mode is flattened only

Author: mafredri

session/doc.go

@@ -45,31 +45,29 @@ Manager by checking the error channel:
 		// Manager is closed.
 	}()
 
-# Manual session management
+# Manual session management (flattened protocol)
 
-For more control, sessions can be created directly via rpcc.NewSession
-without using the Manager:
+For more control, flattened sessions can be created directly via rpcc.NewSession
+without using the Manager.
 
-	reply, err := c.Target.AttachToTarget(ctx,
-		target.NewAttachToTargetArgs(targetID).SetFlatten(true))
+	reply, err := c.Target.AttachToTarget(ctx, target.NewAttachToTargetArgs(targetID).SetFlatten(true))
 	if err != nil {
 		// Handle error.
 	}
 
-	sessionConn, err := rpcc.NewSession(conn, string(reply.SessionID),
-		rpcc.WithSessionClose(func(ctx context.Context) error {
-			return c.Target.DetachFromTarget(ctx,
-				target.NewDetachFromTargetArgs().SetSessionID(reply.SessionID))
-		}))
+	sessConn, err := rpcc.NewSession(conn, string(reply.SessionID), rpcc.WithSessionClose(func(ctx context.Context) error {
+		args := target.NewDetachFromTargetArgs().SetSessionID(reply.SessionID)
+		return c.Target.DetachFromTarget(ctx, args)
+	}))
 	if err != nil {
 		// Handle error.
 	}
-	defer sessionConn.Close()
+	defer sessConn.Close()
 
-	sessionClient := cdp.NewClient(sessionConn)
+	sessClient := cdp.NewClient(sessConn)
 	// ...
 
-The WithSessionClose callback handles detachment when you close the session.
+The WithSessionClose function handles detachment when you close the session.
 Note that Chrome may also detach sessions (e.g. when a target is destroyed).
 For short-lived operations this can be ignored, but for long-lived sessions
 you should listen for Target.DetachedFromTarget events or use the Manager.