mirror of
https://github.com/ansible/ansible.git
synced 2026-07-28 08:05:22 +02:00
1378412a9e
* Deconstruct AGENTS.md to context dir * Split guidelines applicable to both humans and agents to top-level `context` dir. * Instruct agents to read all context files for now- piecemeal/just-in-time context ingestion has been spotty and problematic to date. Co-authored-by: Matt Clay <matt@mystile.com> Assisted-by: Claude * update package-data sanity to ignore context * markdown line length sanity * Ignore context dir in change detection * Remove core plugin deprecation instructions * Inconsistent with published docs and docsite behavior- resolve those first. --------- Co-authored-by: Matt Clay <matt@mystile.com>
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.