fix(docs): repair all broken links

LittleCoinCoin · LittleCoinCoin · commit e9113249a9c6 · 2025-12-11T16:55:28.000+09:00
diff --git a/docs/articles/devs/architecture/component_architecture.md b/docs/articles/devs/architecture/component_architecture.md
@@ -287,5 +287,5 @@ This article is about:
 ## Related Documentation
 
 - [System Overview](./system_overview.md) - High-level architecture introduction
-- [Implementation Guides](../implementation_guides/) - Technical implementation guidance for specific components
-- [Development Processes](../development_processes/) - Development workflow and testing standards
+- [Implementation Guides](../implementation_guides/index.md) - Technical implementation guidance for specific components
+- [Development Processes](../development_processes/index.md) - Development workflow and testing standards
diff --git a/docs/articles/devs/architecture/index.md b/docs/articles/devs/architecture/index.md
@@ -22,7 +22,7 @@ Design patterns are covered within the main architecture documents:
 
 ## Architecture Diagram
 
-The complete system architecture is documented in the [Architecture Diagram](../../resources/diagrams/architecture.puml), which provides a visual overview of all components and their relationships.
+![Component Architecture](../../../resources/images/architecture.svg)
 
 ## Key Architectural Principles
 
@@ -36,12 +36,11 @@ The complete system architecture is documented in the [Architecture Diagram](../
 If you're new to the Hatch codebase:
 
 1. Start with [System Overview](./system_overview.md) to understand the big picture
-2. Review the [Architecture Diagram](../../resources/diagrams/architecture.puml) for visual context
-3. Explore [Component Architecture](./component_architecture.md) for detailed component understanding
-4. Check [Implementation Guides](../implementation_guides/) when ready to work on specific features
+2. Explore [Component Architecture](./component_architecture.md) for detailed component understanding
+3. Check [Implementation Guides](../implementation_guides/index.md) when ready to work on specific features
 
 ## Related Documentation
 
-- [Implementation Guides](../implementation_guides/) - Technical how-to guides for specific components
-- [Development Processes](../development_processes/) - Development workflow and standards
-- [Contribution Guidelines](../contribution_guides/) - How to contribute to the project
+- [Implementation Guides](../implementation_guides/index.md) - Technical how-to guides for specific components
+- [Development Processes](../development_processes/index.md) - Development workflow and standards
+- [Contribution Guidelines](../contribution_guides/index.md) - How to contribute to the project
diff --git a/docs/articles/devs/architecture/system_overview.md b/docs/articles/devs/architecture/system_overview.md
@@ -142,10 +142,4 @@ Understanding this system overview provides the foundation for working with Hatc
 1. **Start Here** - This overview gives you the big picture
 2. **Dive Deeper** - See [Component Architecture](./component_architecture.md) for detailed component information
 3. **Get Hands-On** - Follow [Developer Onboarding](../development_processes/developer_onboarding.md) for practical next steps
-4. **Implementation** - Check [Implementation Guides](../implementation_guides/) when ready to implement features
-
-## Related Documentation
-
-- [Component Architecture](./component_architecture.md) - Detailed component breakdown
-- [Implementation Guides](../implementation_guides/) - Technical implementation guidance
-- [Development Processes](../development_processes/) - Development workflow and standards
+4. **Implementation** - Check [Implementation Guides](../implementation_guides/index.md) when ready to implement features
diff --git a/docs/articles/devs/contribution_guides/index.md b/docs/articles/devs/contribution_guides/index.md
@@ -4,21 +4,21 @@ This section provides process-focused guidance for contributing to the Hatch pro
 
 ## Overview
 
-These guidelines focus on the contribution process, community standards, and project policies rather than technical implementation details. For technical how-to guides, see [Implementation Guides](../implementation_guides/).
+These guidelines focus on the contribution process, community standards, and project policies rather than technical implementation details. For technical how-to guides, see [Implementation Guides](../implementation_guides/index.md).
 
 ## Available Guidelines
 
 ### Core Contribution Process
 
 - **[How to Contribute](./how_to_contribute.md)** - General contribution workflow, branch naming, and submission process
-- **[Release and Dependency Policy](./release_and_dependency_policy.md)** - Release management policies and dependency guidelines
+- **[Release and Dependency Policy](./release_policy.md)** - Release management policies and dependency guidelines
 
 ## Before Contributing
 
-1. **Review the Architecture** - Understand the system by reading [Architecture Documentation](../architecture/)
-2. **Set Up Development Environment** - Follow [Development Environment Setup](../development_processes/development_environment_setup.md)
+1. **Review the Architecture** - Understand the system by reading [Architecture Documentation](../architecture/index.md)
+2. **Set Up Development Environment** - Follow [Development Environment Setup](../development_processes/developer_onboarding.md)
 3. **Understand Testing Requirements** - Review [Testing Standards](../development_processes/testing_standards.md)
-4. **Check Implementation Guides** - For technical guidance, see [Implementation Guides](../implementation_guides/)
+4. **Check Implementation Guides** - For technical guidance, see [Implementation Guides](../implementation_guides/index.md)
 
 ## Contribution Workflow
 
@@ -37,6 +37,4 @@ These guidelines focus on the contribution process, community standards, and pro
 
 ## Related Documentation
 
-- [Development Processes](../development_processes/) - Development workflow and standards
-- [Implementation Guides](../implementation_guides/) - Technical implementation guidance
-- [Architecture](../architecture/) - System understanding for contributors
+- [Development Processes](../development_processes/index.md) - Development workflow and standards
diff --git a/docs/articles/devs/development_processes/developer_onboarding.md b/docs/articles/devs/development_processes/developer_onboarding.md
@@ -63,8 +63,7 @@ hatch --help
 ### Start with High-Level Architecture
 
 1. **Read** [System Overview](../architecture/system_overview.md) - Understand the big picture
-2. **Review** [Architecture Diagram](../../resources/diagrams/architecture.puml) - Visual system layout
-3. **Examine** [Component Architecture](../architecture/component_architecture.md) - Detailed component breakdown
+2. **Examine** [Component Architecture](../architecture/component_architecture.md) - Detailed component breakdown
 
 ### Key Files to Understand
 
diff --git a/docs/articles/devs/development_processes/index.md b/docs/articles/devs/development_processes/index.md
@@ -46,6 +46,6 @@ All development must follow the [organization-wide](https://github.com/CrackingS
 
 ## Related Documentation
 
-- [Architecture](../architecture/) - Understanding the system you're working on
-- [Implementation Guides](../implementation_guides/) - Technical how-to guides for specific features
-- [Contribution Guidelines](../contribution_guides/) - Process for contributing your work
+- [Architecture](../architecture/index.md) - Understanding the system you're working on
+- [Implementation Guides](../implementation_guides/index.md) - Technical how-to guides for specific features
+- [Contribution Guidelines](../contribution_guides/index.md) - Process for contributing your work
diff --git a/docs/articles/devs/development_processes/testing_standards.md b/docs/articles/devs/development_processes/testing_standards.md
@@ -263,6 +263,6 @@ class TestRegistryCaching(unittest.TestCase):
 
 ## Related Documentation
 
-- [Development Environment Setup](./development_environment_setup.md) - Setting up testing environment
+- [Development Environment Setup](./developer_onboarding.md) - Setting up testing environment
 - [Contribution Guidelines](../contribution_guides/how_to_contribute.md) - Testing requirements for contributions
-- [Implementation Guides](../implementation_guides/) - Testing specific components
+- [Implementation Guides](../implementation_guides/index.md) - Testing specific components
diff --git a/docs/articles/devs/index.md b/docs/articles/devs/index.md
@@ -6,31 +6,31 @@ This section provides comprehensive documentation for developers and contributor
 
 The developer documentation is organized into four main categories to serve different developer needs:
 
-### [Architecture](./architecture/)
+### [Architecture](./architecture/index.md)
 
 High-level system understanding and design patterns for developers getting familiar with the Hatch codebase.
 
 - System overview and component relationships
 - Design patterns and architectural decisions
 - Entry points for new developers
 
-### [Implementation Guides](./implementation_guides/)
+### [Implementation Guides](./implementation_guides/index.md)
 
 Technical how-to guides for implementing specific features and extending the system.
 
 - Adding new installer types
 - Extending core functionality
 - Working with specific system components
 
-### [Development Processes](./development_processes/)
+### [Development Processes](./development_processes/index.md)
 
 Workflow, standards, and processes for effective development on the Hatch project.
 
 - Testing standards and procedures
 - Development environment setup
 - Code quality and review processes
 
-### [Contribution Guidelines](./contribution_guides/)
+### [Contribution Guidelines](./contribution_guides/index.md)
 
 Process-focused guidance for contributing to the Hatch project.
 
@@ -48,18 +48,15 @@ Process-focused guidance for contributing to the Hatch project.
 
 ### For Experienced Developers
 
-1. **Implementing Features** → [Implementation Guides](./implementation_guides/) - Technical how-to guides
+1. **Implementing Features** → [Implementation Guides](./implementation_guides/index.md) - Technical how-to guides
 2. **Understanding Components** → [Component Architecture](./architecture/component_architecture.md) - Detailed component breakdown
 3. **Testing Requirements** → [Testing Standards](./development_processes/testing_standards.md) - Testing patterns and requirements
-4. **Release Process** → [Release and Dependency Policy](./contribution_guides/release_and_dependency_policy.md) - Release management policies
+4. **Release Process** → [Release and Dependency Policy](./contribution_guides/release_policy.md) - Release management policies
 
-## Additional Resources
 
-- **[Architecture Diagram](../../resources/diagrams/architecture.puml)** - Visual overview of system components
 
 ### External Resources
 
-- **[Source Code](../../hatch/)** - Main Hatch package source code
 - **[GitHub Repository](https://github.com/CrackingShells/Hatch)** - Project repository
 - **[Hatch Schemas](https://github.com/CrackingShells/Hatch-Schemas)** - Package metadata schemas
 - **[Hatch Registry](https://github.com/CrackingShells/Hatch-Registry)** - Central package registry
diff --git a/docs/articles/users/GettingStarted.md b/docs/articles/users/GettingStarted.md
@@ -238,24 +238,17 @@ Now that you have Hatch installed and understand the basics:
 ### Next Steps
 
 1. **Complete the tutorial series**:
-   - [Environment Management](tutorials/02-environments/) - Advanced environment operations
-   - [Package Authoring](tutorials/03-author-package/) - Create your own packages
-   - [MCP Host Configuration](tutorials/04-mcp-host-configuration/) - Deploy packages to host platforms
+   - [Environment Management](tutorials/02-environments/01-manage-envs.md) - Advanced environment operations
+   - [Package Authoring](tutorials/03-author-package/01-generate-template.md) - Create your own packages
+   - [MCP Host Configuration](tutorials/04-mcp-host-configuration/01-host-platform-overview.md) - Deploy packages to host platforms
 
 2. **Explore reference documentation**:
    - [CLI Reference](CLIReference.md) - Complete command documentation
-   - [Troubleshooting](Troubleshooting/CommonIssues.md) - Solutions to common issues
 
 3. **Understand limitations**:
    - [Limits and Known Issues](../appendices/LimitsAndKnownIssues.md) - Current constraints and workarounds
    - [Security and Trust](SecurityAndTrust.md) - Security model and deployment guidance
 
-### Getting Help
-
-**Documentation**: Start with the [troubleshooting guide](Troubleshooting/CommonIssues.md) for common issues.
-
-**Community**: Check the GitHub repository for issues and discussions.
-
 **Diagnostics**: Use these commands to gather information when seeking help:
 ```bash
 hatch --help
diff --git a/docs/articles/users/MCPHostConfiguration.md b/docs/articles/users/MCPHostConfiguration.md
@@ -154,10 +154,6 @@ hatch mcp configure weather_server \
   --args weather_server.py
 ```
 
-### Advanced Synchronization
-
-Hatch provides comprehensive synchronization capabilities for managing MCP configurations across environments and hosts. For hands-on learning, see [Tutorial: Environment Synchronization](tutorials/04-mcp-host-configuration/04-environment-synchronization.md) and [Tutorial: Advanced Synchronization](tutorials/04-mcp-host-configuration/05-advanced-synchronization.md).
-
 #### Quick Examples
 
 ```bash
@@ -472,4 +468,4 @@ The system validates host names against available MCP host types:
 
 Invalid host names result in clear error messages with available options listed.
 
-For complete command syntax and all available options, see [CLI Reference](CLIReference.md#mcp-commands).
+For complete command syntax and all available options, see [CLI Reference](CLIReference.md).
diff --git a/docs/articles/users/tutorials/01-getting-started/03-install-package.md b/docs/articles/users/tutorials/01-getting-started/03-install-package.md
@@ -78,7 +78,7 @@ Hatch!'s package registry is almost empty as of now (until you contribute your o
 hatch package add /path/to/my-package
 ```
 
-If you don't have a local package yet, you can create one using the `hatch create` command. This will be covered in the [Author Package](../03-author-package/01-create-package.md) tutorial. For now though, let us proceed with the next step.
+If you don't have a local package yet, you can create one using the `hatch create` command. This will be covered in the [Author Package](../03-author-package/01-generate-template.md) tutorial. For now though, let us proceed with the next step.
 
 ## Step 4: Verify Installation
 
diff --git a/docs/articles/users/tutorials/03-author-package/05-checkpoint.md b/docs/articles/users/tutorials/03-author-package/05-checkpoint.md
@@ -11,7 +11,7 @@
 
 **Next steps:**
 
-- Deploy your packages to MCP host platforms with [MCP Host Configuration](../04-mcp-host-configuration/)
+- Deploy your packages to MCP host platforms with [MCP Host Configuration](../04-mcp-host-configuration/01-host-platform-overview.md)
 - Explore advanced CLI features and configuration options
 - Learn about security considerations and troubleshooting
 - Understand the development architecture for contributing
diff --git a/docs/articles/users/tutorials/04-mcp-host-configuration/01-host-platform-overview.md b/docs/articles/users/tutorials/04-mcp-host-configuration/01-host-platform-overview.md
@@ -245,4 +245,4 @@ You now understand the MCP host configuration landscape and Hatch's role as a pa
 
 - [CLI Reference](../../CLIReference.md) - Complete command syntax
 - [Getting Started Guide](../../GettingStarted.md) - Basic Hatch concepts
-- [Package Authoring Tutorial](../03-author-package/) - Creating packages for deployment
+- [Package Authoring Tutorial](../03-author-package/01-generate-template.md) - Creating packages for deployment
diff --git a/docs/articles/users/tutorials/04-mcp-host-configuration/02-configuring-hatch-packages.md b/docs/articles/users/tutorials/04-mcp-host-configuration/02-configuring-hatch-packages.md
@@ -53,7 +53,7 @@ hatch package add my-weather-server --host claude-desktop
 
 ## Step 1: Deploy Package to Single Host
 
-Use the package you created in [Tutorial 03](../03-author-package/) for this exercise.
+Use the package you created in [Tutorial 03](../03-author-package/01-generate-template.md) for this exercise.
 
 ### Basic Package Deployment
 
@@ -279,6 +279,5 @@ You now understand the preferred method for deploying MCP servers using Hatch pa
 **Continue to**: [Tutorial 04-03: Configuring Arbitrary Servers](03-configuring-arbitrary-servers.md) to learn the alternative direct configuration method for non-Hatch MCP servers.
 
 **Related Documentation**:
-- [Package Commands Reference](../../CLIReference.md#package-commands) - Complete command syntax
-- [MCP Host Configuration Guide](../../MCPHostConfiguration.md#package-deployment) - Advanced deployment strategies
-- [Package Authoring Tutorial](../03-author-package/) - Creating packages for deployment
+- [Package Commands Reference](../../CLIReference.md#hatch-package-package-management) - Complete command syntax
+- [Package Authoring Tutorial](../03-author-package/01-generate-template.md) - Creating packages for deployment
diff --git a/docs/articles/users/tutorials/04-mcp-host-configuration/03-configuring-arbitrary-servers.md b/docs/articles/users/tutorials/04-mcp-host-configuration/03-configuring-arbitrary-servers.md
@@ -358,6 +358,5 @@ You now understand how to configure arbitrary MCP servers using direct configura
 **Continue to**: [Tutorial 04-04: Environment Synchronization](04-environment-synchronization.md) to learn how to synchronize MCP configurations across environments and hosts.
 
 **Related Documentation**:
-- [MCP Commands Reference](../../CLIReference.md#mcp-commands) - Complete command syntax
-- [MCP Host Configuration Guide](../../MCPHostConfiguration.md#direct-configuration) - Advanced configuration strategies
+- [MCP Commands Reference](../../CLIReference.md) - Complete command syntax
 - [Package Deployment Tutorial](02-configuring-hatch-packages.md) - Preferred deployment method
diff --git a/docs/articles/users/tutorials/04-mcp-host-configuration/04-environment-synchronization.md b/docs/articles/users/tutorials/04-mcp-host-configuration/04-environment-synchronization.md
@@ -315,9 +315,8 @@ hatch mcp sync --from-env "$project_env" --to-host "$target_hosts" --auto-approv
 
 **Related Documentation**:
 
-- [MCP Host Configuration Guide](../../MCPHostConfiguration.md#multi-host-deployment) - Comprehensive deployment reference
-- [MCP Sync Commands Reference](../../CLIReference.md#mcp-sync) - Complete command syntax
-- [Environment Management Tutorial](../02-environments/) - Advanced environment operations
+- [MCP Sync Commands Reference](../../CLIReference.md#hatch-mcp-sync) - Complete command syntax
+- [Environment Management Tutorial](../02-environments/01-manage-envs.md) - Advanced environment operations
 
 > Previous: [Edit Metadata](03-configuring-arbitrary-servers.md)
 > Next: [Checkpoint](05-checkpoint.md)
diff --git a/docs/articles/users/tutorials/04-mcp-host-configuration/05-checkpoint.md b/docs/articles/users/tutorials/04-mcp-host-configuration/05-checkpoint.md
@@ -26,7 +26,7 @@ You now have comprehensive skills for managing MCP server deployments across dif
 ## Deployment Strategy Decision Framework
 
 ### Choose Package-First Deployment When:
-- ✅ You have Hatch packages (from [Tutorial 03](../03-author-package/))
+- ✅ You have Hatch packages (from [Tutorial 03](../03-author-package/01-generate-template.md))
 - ✅ You want automatic dependency resolution
 - ✅ You need environment isolation and rollback capabilities
 - ✅ You want the most reliable and maintainable deployment workflow
@@ -62,12 +62,12 @@ You now have comprehensive skills for managing MCP server deployments across dif
 
 ### Hatch Feature Integration
 
-**Environment Management** ([Tutorial 02](../02-environments/)):
+**Environment Management** ([Tutorial 02](../02-environments/01-manage-envs.md)):
 - Create isolated environments for different projects
 - Maintain separate package sets for development/production
 - Use environment synchronization for deployment
 
-**Package Management** ([Tutorial 03](../03-author-package/)):
+**Package Management** ([Tutorial 03](../03-author-package/01-generate-template.md)):
 - Develop MCP servers as Hatch packages
 - Include complete dependency specifications
 - Deploy packages with automatic dependency resolution
diff --git a/docs/index.md b/docs/index.md
diff --git a/mkdocs.yml b/mkdocs.yml
