# Updating the Getting Started with Ansible diagram **URL:** \ **Category:** Project Discussions\ **Tags:** documentation\ **Created:** [October 18, 2023, 2:31pm UTC](https://forum.ansible.com/t/updating-the-getting-started-with-ansible-diagram/1783 "2023-10-18T14:31:48Z")\ **Posts on this page:** 11\ **Page:** 1
**Author:** ![oranod](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/oranod/32/1434_2.png) [@oranod](https://forum.ansible.com/u/oranod)\ **Post date:** [October 18, 2023, 2:31pm UTC](https://forum.ansible.com/t/updating-the-getting-started-with-ansible-diagram/1783/1 "2023-10-18T14:31:48Z")
Hi all, @tiyip has been done a wonderful job designing the new community website so I asked her if she’d also mind revamping the basic Ansible graphic in the [getting started docs](https://docs.ansible.com/ansible/latest/getting_started/index.html). Full confession, I created the original in Inkscape but am not really the person you want to design graphics. So I was keen to get someone with Tina’s talents to improve that part of the docs. After all, it’s intended for first-time Ansible users so we want to make a good impression. Tina and I have gone through a couple of iterations of the new graphic and wanted to open this up to opinions here. This is what we’ve got so far. Let us know what you think! ![AnsibleGraphic2](https://us1.discourse-cdn.com/ansible/original/2X/c/cb5aab2229d7c6cfeb73afd42464a27ccc95f518.svg) ---
**Author:** ![gwmngilfen](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gwmngilfen/32/6_2.png) [@gwmngilfen](https://forum.ansible.com/u/gwmngilfen)\ **Post date:** [October 18, 2023, 3:45pm UTC](https://forum.ansible.com/t/updating-the-getting-started-with-ansible-diagram/1783/2 "2023-10-18T15:45:00Z")
Like it! Does it make sense to add a ➕ between Ansible and Inventory to make it clear you combine these two things to do **magic**? 😛 ---
**Author:** ![oranod](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/oranod/32/1434_2.png) [@oranod](https://forum.ansible.com/u/oranod)\ **Post date:** [October 18, 2023, 3:57pm UTC](https://forum.ansible.com/t/updating-the-getting-started-with-ansible-diagram/1783/3 "2023-10-18T15:57:41Z")
Yeah I think that could work but an inventory isn’t always necessary so maybe the + would imply that? ---
**Author:** ![samccann](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/samccann/32/18_2.png) [@samccann](https://forum.ansible.com/u/samccann)\ **Post date:** [October 18, 2023, 4:43pm UTC](https://forum.ansible.com/t/updating-the-getting-started-with-ansible-diagram/1783/4 "2023-10-18T16:43:28Z")
My nickel is this image already implies inventory is necessary, so the + adds a bit of value imo. …and it’s getting started, and I think you have an inventory in the example so… all good 🙂 ---
**Author:** ![utoddl](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/utoddl/32/249_2.png) [@utoddl](https://forum.ansible.com/u/utoddl)\ **Post date:** [October 18, 2023, 6:40pm UTC](https://forum.ansible.com/t/updating-the-getting-started-with-ansible-diagram/1783/5 "2023-10-18T18:40:37Z")
Should that be “Ansible”, or “`ansible-playbook`” in the first box? At the risk of feature creep, this feels to me like the 2nd diagram in a series: - The first would be `ansible-playbook` with no inventory running on and managing `localhost`. It’s all in one box. - Then this diagram (which, btw, seems fine to me, to address your question). - Then one showing an [SCM node], [AWX with internal organizations], [external inventory sources], and [managed nodes]. (The square brackets are supposed to imply possible boxes.) I’m thinking a newbie could scroll through and at a glance — literally — get a sense of how ansible deployments might scale. ---
**Author:** ![oranod](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/oranod/32/1434_2.png) [@oranod](https://forum.ansible.com/u/oranod)\ **Post date:** [October 19, 2023, 9:36am UTC](https://forum.ansible.com/t/updating-the-getting-started-with-ansible-diagram/1783/6 "2023-10-19T09:36:26Z")
Hey @utoddl thanks for that suggestion. I like it a lot. Yeah it might be somewhat of a scope creep from the initial ask but getting a visual sense of how deployments scale could really help click things into place for newbies. (Full confession I still consider myself a newbie in comparison with lots of others around here.) That will take a bit of rewriting / finessing in the “Getting started with Ansible” content itself but I can try and come up with something. ---
**Author:** ![maxamillion](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/maxamillion/32/98_2.png) [@maxamillion](https://forum.ansible.com/u/maxamillion)\ **Post date:** [October 19, 2023, 10:19pm UTC](https://forum.ansible.com/t/updating-the-getting-started-with-ansible-diagram/1783/7 "2023-10-19T22:19:54Z")
+1 - I fear that adding too much to this image would be scope creep. I think initially just running the command `ansible` for an ad-hoc task to demonstrate how to combine it with an inventory to perform a single task is a powerful moment that then leads the new user to the obvious next step of “how do I combine these tasks so I don’t have to keep running commands?” and that answer is Playbooks! I would think Ansible + Inventory + Playbook could be another graphic, perhaps the same graphic with some added elements to illustrate the building block concepts. ---
**Author:** ![tiyip](https://avatars.discourse-cdn.com/v4/letter/t/dc4da7/32.png) [@tiyip](https://forum.ansible.com/u/tiyip)\ **Post date:** [October 24, 2023, 4:42pm UTC](https://forum.ansible.com/t/updating-the-getting-started-with-ansible-diagram/1783/8 "2023-10-24T16:42:24Z")
Hi, here is an updated image: ![AnsibleGraphic2](https://us1.discourse-cdn.com/ansible/original/2X/c/c94685c030b9c433b846222926f24aae70e66262.png) ---
**Author:** ![oranod](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/oranod/32/1434_2.png) [@oranod](https://forum.ansible.com/u/oranod)\ **Post date:** [October 25, 2023, 1:18pm UTC](https://forum.ansible.com/t/updating-the-getting-started-with-ansible-diagram/1783/9 "2023-10-25T13:18:10Z")
Thanks a mill @tiyip I think that looks good and, seeing it, agree that the plus sign is effective. I’ve added this to a [pull request](https://github.com/ansible/ansible-documentation/pull/711) like we talked about on Matrix and the [build preview](https://ansible--711.org.readthedocs.build/projects/ansible-core/en/711/getting_started/index.html) is ready. I was thinking maybe we should just have “node 1, node 2, node 3” because they are grouped in the “managed nodes” box. What do you guys think? ---
**Author:** ![gwmngilfen](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/gwmngilfen/32/6_2.png) [@gwmngilfen](https://forum.ansible.com/u/gwmngilfen)\ **Post date:** [October 25, 2023, 1:32pm UTC](https://forum.ansible.com/t/updating-the-getting-started-with-ansible-diagram/1783/10 "2023-10-25T13:32:48Z")
I’d agree, the word “managed” seems redundant on the nodes. However, I’m not **strongly** opposed to it, some people need that reinforcement. ---
**Author:** ![Leo](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/leo/32/23_2.png) [@Leo](https://forum.ansible.com/u/Leo)\ **Post date:** [October 25, 2023, 6:57pm UTC](https://forum.ansible.com/t/updating-the-getting-started-with-ansible-diagram/1783/11 "2023-10-25T18:57:23Z")
> [@oranod](#): > > I was thinking maybe we should just have “node 1, node 2, node 3” because they are grouped in the “managed nodes” box. What do you guys think? I like the new design! I would keep the **managed** in the small boxes as well, when starting it’s good to have refreshers and it’s not making it too noisy.