Create a 'getting started' guide for developers

[samccann]

SUMMARY

This came up as a possible ansibleFest topic, so thought it would be worth having a specific getting started guide for developers so they can quickly learn how to:

• get ansible from source and set up your basic development environment
• Open a PR for a bugfix or new option to a module
• how to find the module source code in the collections world
• PR requirements like changelogs, unit tests, etc
• keeping your PR current for newer versions of the upstream repo

(git remote add ; git fetch ; git merge --ff-only to devel ; git checkout feature-branch ; git rebase devel )

ISSUE TYPE

• Documentation Report

COMPONENT NAME

docs.ansible.com

ANSIBLE VERSION

CONFIGURATION

OS / ENVIRONMENT

ADDITIONAL INFORMATION

[samccann]

https://github.com/greg-hellings/ansible_collection_demo - has some info that might be helpful for starting a new collection.

[s-hertel]

@samccann Can you move this to the new repo?

[samccann]

yes I plan on going through all the docs issues after June 10th to move them all over. That' the proposed 'official' date when the split happens. I can try to do it sooner, but I'm out from Friday until that date so didn't want to rush it all.

[s-hertel]

Thanks, this was just in our backlog queue.

[oraNod]

Estimated effort: L (MUNI tech writers)

[xszabo3]

@oraNod Hi! Can I work on this issue?

[oraNod]

@xszabo3 Welcome! Yes, please go ahead. I've assigned this issue to you. Feel free to ask any questions here or in the docs channel on Matrix.

[samccann]

Thanks to @xszabo3 for realizing this issue was actually already solved by https://docs.ansible.com/ansible/latest/community/create_pr_quick_start.html. I'll create a new issue for what was discussed in the docs matrix channel and assign the new one to you (as it is of similar scope/size).