geerlingguy / geerlingguy/ansible-for-devops

Roles only require a single directory (e.g. `tasks`), don't require meta dir

Open
#315 0 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
9.9k
Forks
3.8k
PR merge metrics
No merged PRs in 30d

Description

From a reader's email:

> I found an error or confusing part that needs clarification on p132 (Role scaffolding):
>
> "There are only two directories required to make a working Ansible role:"
>
> ```
> role_name/
> meta/
> tasks/
> ```
>
> However, the documentation seems to say otherwise (https://docs.ansible.com/ansible/latest/user_guide/playbooks_reuse_roles.html#role-directory-structure):
>
> "Roles must include at least one of these directories, however it is perfectly fine to exclude any which are not being used."
>
> So you can indeed have a role with only a tasks folder and the meta folder can be left out.
>
> Sincerely
> Daniel S

True! I'll have to fix up the book's statement.

Contributor guide

No contributing guide indexed for this repository

Research direction

Start with the role scaffolding section on page 132 and compare its quoted directory example with the Ansible role-directory documentation linked in the issue. Update the book's statement so it accurately describes the minimum required structure, then check that the surrounding explanation remains consistent.

Written by the indexing model from the issue text.

Assessment

Tech stack
ansible
Domain
documentation
Issue type
Documentation
Difficulty
1/5
Estimated time
Under an hour
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
50/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.