Hi Matt, > Unfortunately I'm still very lost. > (Which means there's probably lots of other potential contributors > who are lost too.) > > > If you have the module in your collection path > > What's a collection path? > Do you mean that iam_role.py needs to be in a directory within my OS > $PATH variable? > > Or do you mean this: > https://docs.ansible.com/ansible/latest/reference_appendices/config.html#collections-paths
yes, that's meant. > If the latter, which folder do I put in that path? > https://github.com/ansible-collections/community.aws/tree/master/plugins/modules > or > https://github.com/ansible-collections/community.aws > or a folder that contains the clone of > https://github.com/ansible-collections/community.aws ? The folder which contains ansible_collections. That's a folder containing the folder community/aws (which finally is the checkout of https://github.com/ansible-collections/community.aws). This is all described in https://docs.ansible.com/ansible/devel/dev_guide/developing_collections.html#contributing-to-collections > I tried a -m command and got: > > ERROR! this task 'community.aws/iam_role.py' has extra params, which > is only allowed in the following modules: import_tasks, raw, > ansible.windows. win_command, win_command, add_host, meta, > include_role, command, include_vars, include, win_shell, import_role, > ansible.windows.win_shell, shell, include_tasks, group_by, set_fact, > script So you did `ansible localhost -m command`? Or what exactly did you do to receive this error? > How long do you expect it will take a newcomer to start contributing > under this new split repo setup? > Is it supposed to take 20 minutes, 3 hours? What's a realistic > timeframe you're aiming for? I would expect that with the instructions in https://docs.ansible.com/ansible/devel/dev_guide/developing_collections.html#contributing-to-collections it should go pretty fast (assuming you already know Ansible). I'm sure this section can be improved, but I think it already contains everything important. Which parts of it were confusing to you that you didn't succeed in setting up your dev environment? Thanks, Felix > I've contributed to Ansible before, and I'm still struggling. It was > a struggle before, and even more of a struggle now. > The relevant documentation just seems spread over too many pages. > I think someone who knows how this works should make a quick start > guide, like this > <https://github.com/ansible-collections/community.aws/issues/120#issuecomment-651715514>. > > Just 4 paragraphs and 4 code blocks of commands. > > Thanks, > Matt -- You received this message because you are subscribed to the Google Groups "Ansible Development" group. To unsubscribe from this group and stop receiving emails from it, send an email to ansible-devel+unsubscr...@googlegroups.com. To view this discussion on the web visit https://groups.google.com/d/msgid/ansible-devel/20200630141252.29172434%40rovaniemi.
