docs: Updated document weights to optimize content structure and navigation

TBXark · TBXark · commit ff696483af37 · 2025-08-29T17:25:37.000+08:00
diff --git a/content/docs/components/cli/sphere-cli.md b/content/docs/components/cli/sphere-cli.md
@@ -1,6 +1,6 @@
 ---
 title: Sphere CLI
-weight: 10
+weight: 32
 ---
 
 Sphere CLI (`sphere-cli`) is a command-line tool designed to streamline the development of [Sphere](https://github.com/go-sphere/sphere) projects. It helps you create new projects, generate service code, manage Protobuf definitions, and perform other common development tasks.
diff --git a/content/docs/components/core.md b/content/docs/components/core.md
@@ -1,6 +1,6 @@
 ---
 title: Core
-weight: 10
+weight: 33
 ---
 
 Sphere Core repositories and what they provide.
diff --git a/content/docs/components/generators/_index.md b/content/docs/components/generators/_index.md
@@ -1,6 +1,6 @@
 ---
 title: Generators
-weight: 20
+weight: 34
 ---
 
 Protobuf-centric generators that produce handlers, bindings, routing glue, and typed errors.
@@ -9,8 +9,8 @@ Protobuf-centric generators that produce handlers, bindings, routing glue, and t
 
 {{< cards >}}
   {{< card link="protoc-gen-route" title="protoc-gen-route" icon="template" >}}
-  {{< card link="protoc-gen-sphere" title="protoc-gen-sphere" icon="sparkles" >}}
   {{< card link="protoc-gen-sphere-binding" title="protoc-gen-sphere-binding" icon="document-duplicate" >}}
   {{< card link="protoc-gen-sphere-errors" title="protoc-gen-sphere-errors" icon="variable" >}}
+  {{< card link="protoc-gen-sphere" title="protoc-gen-sphere" icon="sparkles" >}}
 {{< /cards >}}
 
diff --git a/content/docs/components/generators/protoc-gen-route.md b/content/docs/components/generators/protoc-gen-route.md
@@ -1,6 +1,6 @@
 ---
 title: protoc-gen-route
-weight: 20
+weight: 35
 ---
 
 `protoc-gen-route` is a protoc plugin that generates routing code from `.proto` files. It is designed to inspect service definitions within your protobuf files and automatically generate corresponding route handlers based on a specified template. This plugin creates Go code that provides structured routing with operation constants, extra data handling, server interfaces, and codec interfaces for seamless integration with various transport protocols.
diff --git a/content/docs/components/generators/protoc-gen-sphere-binding.md b/content/docs/components/generators/protoc-gen-sphere-binding.md
@@ -1,6 +1,6 @@
 ---
 title: protoc-gen-sphere-binding
-weight: 30
+weight: 36
 ---
 
 `protoc-gen-sphere-binding` is a protoc plugin that generates Go struct tags for Sphere binding from `.proto` files. It is designed to inspect service definitions within your protobuf files and automatically generate corresponding Go struct tags based on sphere binding annotations.
diff --git a/content/docs/components/generators/protoc-gen-sphere-errors.md b/content/docs/components/generators/protoc-gen-sphere-errors.md
@@ -1,6 +1,6 @@
 ---
 title: protoc-gen-sphere-errors
-weight: 40
+weight: 37
 ---
 
 `protoc-gen-sphere-errors` is a protoc plugin that generates error handling code from `.proto` files. It is designed to inspect enum definitions within your protobuf files and automatically generate corresponding error handling code based on the sphere errors framework. This plugin creates Go code that provides structured error handling with HTTP status codes, error codes, and customizable messages.
diff --git a/content/docs/components/generators/protoc-gen-sphere.md b/content/docs/components/generators/protoc-gen-sphere.md
@@ -1,6 +1,6 @@
 ---
 title: protoc-gen-sphere
-weight: 10
+weight: 38
 ---
 
 Generates HTTP server code from `.proto` service definitions, using `google.api.http` annotations and Sphere server utilities (Gin-based).
diff --git a/content/docs/concepts/architecture-and-repo.md b/content/docs/concepts/architecture-and-repo.md
@@ -1,6 +1,6 @@
 ---
 title: Architecture & Repository Strategy
-weight: 40
+weight: 25
 aliases:
   - /docs/concepts/microservice-architecture/
   - /docs/concepts/code-repository-types/
diff --git a/content/docs/concepts/project-structure.md b/content/docs/concepts/project-structure.md
@@ -1,6 +1,6 @@
 ---
 title: Project Structure
-weight: 10
+weight: 21
 aliases:
   - /docs/concepts/project-code-structure/
   - /docs/concepts/project-layout/
diff --git a/content/docs/concepts/proto-packages.md b/content/docs/concepts/proto-packages.md
@@ -1,6 +1,6 @@
 ---
 title: Proto Packages
-weight: 30
+weight: 22
 ---
 
 Sphere provides several core proto packages that extend Protobuf with specialized annotations for HTTP binding, error handling, and method options. These packages enable the code generation pipeline and provide the foundation for Sphere's contract-first approach.
diff --git a/content/docs/concepts/protocol-and-codegen.md b/content/docs/concepts/protocol-and-codegen.md
@@ -1,6 +1,6 @@
 ---
 title: Protocol & Codegen
-weight: 20
+weight: 23
 aliases:
   - /docs/concepts/protobuf-protocol/
   - /docs/concepts/code-generation-engine/
diff --git a/content/docs/concepts/runtime.md b/content/docs/concepts/runtime.md
@@ -1,5 +1,6 @@
 ---
 title: Runtime & Server
+weight: 24
 ---
 
 Sphere’s HTTP layer builds on Gin with small helpers to keep handlers concise and error responses consistent.
diff --git a/content/docs/getting-started/quickstart.md b/content/docs/getting-started/quickstart.md
@@ -1,6 +1,6 @@
 ---
 title: Quick Start
-weight: 10
+weight: 11
 aliases:
   - /docs/start/getting-started/
   - /docs/start/getting-started
diff --git a/content/docs/getting-started/workflow.md b/content/docs/getting-started/workflow.md
@@ -1,6 +1,6 @@
 ---
 title: Development Workflow
-weight: 20
+weight: 12
 aliases:
   - /docs/start/workflow/
   - /docs/start/workflow
diff --git a/content/docs/guides/_index.md b/content/docs/guides/_index.md
@@ -1,6 +1,6 @@
 ---
 title: Guides
-weight: 30
+weight: 40
 ---
 
 Hands-on topics and best practices.
diff --git a/content/docs/guides/api-definitions.md b/content/docs/guides/api-definitions.md
@@ -1,5 +1,6 @@
 ---
 title: API Definitions
+weight: 41
 ---
 
 Sphere allows you to define HTTP interfaces for your services using standard Protobuf definitions and `google.api.http` annotations. This document outlines the rules and conventions for mapping your gRPC methods to RESTful HTTP endpoints.
diff --git a/content/docs/guides/error-handling.md b/content/docs/guides/error-handling.md
@@ -1,5 +1,6 @@
 ---
 title: Error Handling
+weight: 42
 ---
 
 Sphere provides a powerful mechanism for generating typed, consistent error-handling code directly from your `.proto` definitions. By defining your errors as enums, you can ensure that error codes, HTTP statuses, and messages are standardized across your application.
diff --git a/content/docs/guides/logging.md b/content/docs/guides/logging.md
@@ -1,6 +1,6 @@
 ---
 title: Logging
-weight: 30
+weight: 43
 ---
 
 Sphere provides a flexible and powerful logging system built on top of `go.uber.org/zap`, a high-performance structured logger. It supports multiple outputs, including console and file, and is designed for both local development and production environments.
