# galaxy and playbooks

**URL:** <https://forum.ansible.com/t/galaxy-and-playbooks/14540>\
**Category:** Ansible Project\
**Tags:** galaxy-ng\
**Created:** [February 11, 2014, 4:50pm UTC](https://forum.ansible.com/t/galaxy-and-playbooks/14540 "2014-02-11T16:50:15Z")\
**Posts on this page:** 2\
**Page:** 1

<div class="post-metadata">

**Author:** ![James\_Martin2](https://avatars.discourse-cdn.com/v4/letter/j/b9e5f3/32.png) [@James\_Martin2](https://forum.ansible.com/u/James_Martin2)\
**Post date:** [February 11, 2014, 4:50pm UTC](https://forum.ansible.com/t/galaxy-and-playbooks/14540/1 "2014-02-11T16:50:15Z")

</div>

I’m putting some finishing touches on a number of riak related roles. Since riak is a distributed system, these roles really don’t shine unless they are used on a number of hosts. I’d like to provide some example playbooks with the roles that show how to do this, but it seems there is no convention other than placing examples in the readme. Is it alright to include an examples directory for playbooks & inventory?

- James

---

<div class="post-metadata">

**Author:** ![James\_Cammarata](https://avatars.discourse-cdn.com/v4/letter/j/7c8e57/32.png) [@James\_Cammarata](https://forum.ansible.com/u/James_Cammarata)\
**Post date:** [February 12, 2014, 1:27am UTC](https://forum.ansible.com/t/galaxy-and-playbooks/14540/2 "2014-02-12T01:27:09Z")

</div>

It will be included in the tarball that is downloaded from github, but I think the correct place to show at least some examples would be in the README, as that’s what most people will see. You can include documentation there to show that there are more complex example playbooks in the examples directory though, which is a good idea.