docs: refine comments based on code review feedback

Copilot · asim · Copilot · commit 93147c5902e1 · 2025-11-25T09:23:11.000Z
- Clarify that Server ordering before Name is mandatory
- Remove confusing comment about Client ordering being for consistency

Co-authored-by: asim &lt;17530+asim@users.noreply.github.com&gt;
diff --git a/internal/website/docs/guides/grpc-compatibility.md b/internal/website/docs/guides/grpc-compatibility.md
@@ -156,7 +156,6 @@ import (
 
 func main() {
     // Create service with gRPC client
-    // Note: Client should be set before Name for consistency
     service := micro.NewService(
         micro.Client(grpcClient.NewClient()),
         micro.Name("helloworld.client"),
diff --git a/internal/website/docs/transport.md b/internal/website/docs/transport.md
@@ -29,11 +29,11 @@ import (
     grpcClient "go-micro.dev/v5/client/grpc"
 )
 
-// Note: Server and Client options should be specified before Name
+// Important: Server must be specified before Name
 service := micro.NewService(
     micro.Server(grpcServer.NewServer()),
     micro.Client(grpcClient.NewClient()),
-    micro.Name("myservice"),  // Name must come after Server
+    micro.Name("myservice"),
 )
 ```
 

Original file line number	Diff line number	Diff line change
`@@ -29,11 +29,11 @@ import (`
`29`	`29`	`grpcClient "go-micro.dev/v5/client/grpc"`
`30`	`30`	`)`
`31`	`31`
`32`		`-// Note: Server and Client options should be specified before Name`
	`32`	`+// Important: Server must be specified before Name`
`33`	`33`	`service := micro.NewService(`
`34`	`34`	`micro.Server(grpcServer.NewServer()),`
`35`	`35`	`micro.Client(grpcClient.NewClient()),`
`36`		`- micro.Name("myservice"), // Name must come after Server`
	`36`	`+ micro.Name("myservice"),`
`37`	`37`	`)`
`38`	`38`	```
`39`	`39`