Outdated docs on collections

The docs say things like to have at least an empty __init__.py, but the stock collections like community.general don’t have one. Instead, they have lots of complex files (JSON in toplevel, YAML and text in meta/, …).

Are the docs outdated and/or incomplete?

__init__.py isn’t necessary, maybe it was a long time ago? This was added 10 years ago in Docs partner checklist (bulk modules) (#20794) · ansible/ansible-documentation@cd6792a · GitHub (and migrated at some point to collections), maybe it was different then?

1 Like

__init__ was required when doing sub directories for ‘adjacent’ plugins (might still be, need to check), but collections for core >2.10 should not need it anymore.

2 Likes