ansible/context

Context for Humans and Agents

This directory contains information about developing ansible-core. It should be equally applicable to both humans and agents.

This is not the place for:

• Documentation on how to use Ansible -- see the ansible-documentation repository.
• Learning how to develop content for Ansible (modules, plugins, collections, roles, etc.) -- see the Ansible Developer Guide.
• Agent-specific instructions or guidance -- see AGENTS.md.

Table of Contents

• contributing - Contributing changes to ansible-core.
• licensing - Licensing requirements.
• dev-environment - Development environment setup.
• code-structure - Directory layout, key components, import restrictions, and plugin policy.
• coding-style - Python versions, dependencies, code formatting, and syntax conventions.
• error-handling - Error and exception handling patterns.
• data-tagging - Working with data tags.
• public-api - Public surface area and internal-by-default conventions.
• documentation-standards - Module/plugin documentation and changelog requirements.
• running-tests - Running tests with ansible-test.
• writing-tests - Test expectations for pull requests.
• deprecation - Backward compatibility and deprecation.
• ci - Continuous integration.