style: fix markdown linting errors in plan documents

Author: damacus

.markdownlint-cli2.yaml

@@ -3,6 +3,8 @@ config:
   line-length: false # MD013
   no-duplicate-heading: false # MD024
   reference-links-images: false # MD052
-  no-multiple-blanks: false # MD032
+  no-multiple-blanks:
+    maximum: 2
 ignores:
   - .github/copilot-instructions.md
+  - .windsurf/**

conductor/future_resources_plan.md

@@ -3,6 +3,7 @@
 This plan outlines the implementation of resources for Docker features that are currently unsupported in the `docker` cookbook, focusing on Swarm management and AI-native capabilities.
 
 ## Objective
+
 - Add support for core Swarm resources: `docker_secret` and `docker_config`.
 - Add support for AI-native Docker features: `docker_model` and `docker_mcp`.
 - Enhance `docker_container` to support `type=image` mounts.
@@ -11,37 +12,45 @@ This plan outlines the implementation of resources for Docker features that are
 ## Proposed Resources
 
 ### 1. Swarm Management
+
 - **`docker_secret`**: Manage Docker secrets (`docker secret create/rm/inspect`).
 - **`docker_config`**: Manage Docker configs (`docker config create/rm/inspect`).
 
 ### 2. AI & Model Management (Docker v28+)
+
 - **`docker_model`**: Resource to pull and manage local LLMs using the new `docker model` CLI.
 - **`docker_mcp`**: Manage Model Context Protocol (MCP) servers and configurations.
 
 ### 3. Storage Enhancements
+
 - **`docker_container` updates**: Add support for `image` type in the `mounts` property to leverage direct layer mounting.
 
 ### 4. Utility Resources
+
 - **`docker_context`**: Manage Docker contexts for switching between local and remote engines.
 
 ## Implementation Steps
 
 ### Phase 1: Swarm Secrets and Configs
+
 1. Create `resources/secret.rb`.
 2. Create `resources/config.rb`.
 3. Add corresponding unit tests in `spec/unit/resources/`.
 4. Add integration tests in a new `test/cookbooks/docker_test/recipes/swarm_resources.rb`.
 
 ### Phase 2: AI-Native Features
+
 1. Research the `docker-api` gem's support for the new model and MCP endpoints.
 2. Implement `resources/model.rb` if CLI execution is required or API is available.
 3. Implement `resources/mcp.rb`.
 
 ### Phase 3: Container & Context
+
 1. Update `resources/container.rb` properties.
 2. Create `resources/context.rb`.
 
 ## Verification & Testing
+
 - **Unit Tests**: Ensure 100% coverage for new resources using ChefSpec.
 - **Integration Tests**: Expand Swarm suites to exercise secrets and configs.
 - **Documentation**: Add new files to `documentation/` for each resource.

conductor/modernization_plan.md

@@ -3,13 +3,15 @@
 This plan outlines the steps to modernize the `docker` cookbook by removing EOL platforms, adding support for newer distributions, and cleaning up legacy code.
 
 ## Objective
+
 - Sync supported platforms across `metadata.rb`, Kitchen files, and CI.
 - Remove EOL platforms (Ubuntu 20.04, Debian 11, AlmaLinux 8, Rocky Linux 8).
 - Add support for new platforms (Debian 13, AlmaLinux 10, Rocky Linux 10).
 - Remove legacy `sysvinit` and `upstart` templates.
 - Ensure all resources follow modern Sous Chefs patterns.
 
 ## Key Files & Context
+
 - `metadata.rb`: Supported platforms and version.
 - `kitchen.yml`, `kitchen.dokken.yml`: Integration test platforms.
 - `.github/workflows/ci.yml`: CI matrix.
@@ -19,6 +21,7 @@ This plan outlines the steps to modernize the `docker` cookbook by removing EOL
 ## Implementation Steps
 
 ### Phase 1: Platform Modernization
+
 1. **Update `metadata.rb`**:
    - Refine `supports` to be more specific if possible, or ensure it accurately reflects the current state.
    - Update `chef_version` to `>= 16.0`.
@@ -32,6 +35,7 @@ This plan outlines the steps to modernize the `docker` cookbook by removing EOL
    - Sync the `integration` and `smoke` matrices with the updated kitchen platforms.
 
 ### Phase 2: Resource Updates
+
 1. **Modernize `resources/installation_package.rb`**:
    - Add `trixie?` helper for Debian 13.
    - Update `version_string` to handle Debian 13.
@@ -41,18 +45,22 @@ This plan outlines the steps to modernize the `docker` cookbook by removing EOL
    - Delete `templates/default/upstart/` directory.
 
 ### Phase 3: Documentation & Maintenance
+
 1. **Version Bump**: Increment version in `metadata.rb`.
 2. **Verify Docs**: Ensure Swarm resources and other new features are accurately documented in `documentation/`.
 
 ## Verification & Testing
 
 ### Unit Testing
+
 - Run `chef exec rspec` to ensure all unit tests pass after changes.
 - Add or update specs for `installation_package` to cover Debian 13.
 
 ### Integration Testing
+
 - Run `kitchen list` to verify updated platform list.
 - Run `kitchen test default-ubuntu-2404` (or other current platform) to ensure basic functionality.
 
 ### Linting
+
 - Run `cookstyle -a` to fix any style offenses.