Skip to content

Conversation

cidrblock
Copy link
Contributor

Overview

This PR introduces comprehensive documentation for Molecule's ansible-native approach and workflow execution model.

New Documentation

ansible-native.md: Technical reference for the ansible-native configuration approach

  • Native inventory usage (static, dynamic, constructed, enterprise)
  • Collection-based resource management (containers, cloud)
  • Shared state configuration and multi-scenario patterns
  • Complete configuration examples with FQCN and raw Jinja tags

pre-ansible-native.md: Compatibility reference for legacy configuration constructs

  • Platforms, drivers, and provisioner configuration patterns
  • Technical explanation of why drivers exist and how ansible-native displaces them
  • Migration guidance and comparison with ansible-native approach

workflow.md: Comprehensive workflow reference covering execution hierarchy

  • Actions (playbooks), sequences (ordered action lists), and subcommands (CLI commands)
  • Sequence vs. direct action command categorization
  • Shared state vs. per-scenario execution patterns
  • Development, debugging, and testing workflow examples

Changes

  • Replaces docs/next.md with structured approach-specific documentation
  • Updates getting-started.md with shared_state configuration and lifecycle explanations
  • Adds new documentation to mkdocs.yml navigation
  • Professional engineering tone throughout all documentation
  • Fully qualified collection names (FQCN) and proper Jinja templating

Target Audience

Engineering teams implementing ansible-native testing workflows and maintaining compatibility with legacy configurations.

…erence

- ansible-native.md: Technical reference for ansible-native configuration approach with native inventory usage, collection-based resource management, and shared state patterns
- pre-ansible-native.md: Compatibility reference for legacy platforms/drivers/provisioner configuration constructs
- workflow.md: Comprehensive workflow reference covering actions, sequences, and subcommands execution hierarchy
- Replace docs/next.md with structured approach-specific documentation
- Update getting-started.md with shared_state configuration and lifecycle explanations
- Professional engineering tone throughout all documentation
@cidrblock cidrblock changed the title docs: Add comprehensive ansible-native documentation and workflow reference Add comprehensive ansible-native documentation and workflow reference Aug 15, 2025
@cidrblock cidrblock merged commit 3c9b5b9 into ansible:main Aug 15, 2025
21 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Archived in project
Development

Successfully merging this pull request may close these issues.

1 participant