I agree, we need to fold more playbook examples into the docs for sure.

Folks might be interested in checking out http://github.com/ansible/ansible-examples for some full-stack use cases showing playbooks that we do have.

I've just picked up ansible, and one thing I found lacking was an example ansible repository with a standard directory layout and config documented on the site or on github. For example, it's not obvious from the docs that a nice way to set things up is:

    site.yml
    ansible.cfg
    hosts
    host_vars/*
    group_vars/*
    roles/*/{files,templates,tasks,handlers,vars}

Have you seen http://www.ansibleworks.com/docs/bestpractices.html ?

Just noticed these don't mention "vars" in the roles directory, do need to fix that :)

I hadn't, doh! Thanks. Might be worth adding a link to that at start of the docs, because I found I was hesitant to start writing yamls without knowing the "right" structure for them.

Oh, thanks, that wasn't there when I started using Ansible. I'll take a look at those, they look very well structured, and very reusable.

These sound awesome. Any pointers on how to modify these for Ubuntu machines?