# Should we have templates available for Ansible documentation?

**URL:** <https://forum.ansible.com/t/should-we-have-templates-available-for-ansible-documentation/27>\
**Category:** Project Discussions\
**Tags:** documentation\
**Created:** [July 21, 2023, 6:05pm UTC](https://forum.ansible.com/t/should-we-have-templates-available-for-ansible-documentation/27 "2023-07-21T18:05:17Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**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:** [July 21, 2023, 6:05pm UTC](https://forum.ansible.com/t/should-we-have-templates-available-for-ansible-documentation/27/1 "2023-07-21T18:05:17Z")

</div>

I stumbled across [The Good Docs Project](https://thegooddocsproject.dev/) from a [Fedora post](https://discussion.fedoraproject.org/t/inspirations-from-the-good-docs-project/85708), and thought it might make for an interesting docs discussion.

TL;DR; - Should we have a small set of .md or .rst files that help developers or other project contributors structure good guides?

We could use the templates in that project or fork/create a smaller set of our own for Ansible ecosystem projects. For the most part, these templates help the author include important parts of documentation that they may not think about at the time they create a new user/developer/contributor guide and so on.

We could create a Documentation Writers toolkit that would explain them as well as cover other details that help a project have quality documentation.

Thoughts?

---

<div class="post-metadata">

**Author:** ![cybette](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/cybette/32/16_2.png) [@cybette](https://forum.ansible.com/u/cybette)\
**Post date:** [July 24, 2023, 7:33am UTC](https://forum.ansible.com/t/should-we-have-templates-available-for-ansible-documentation/27/2 "2023-07-24T07:33:20Z")

</div>

I think it’s a great idea, at least personally I’d appreciate having some templates as guides to help me get started!

---

<div class="post-metadata">

**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:** [July 26, 2023, 2:03pm UTC](https://forum.ansible.com/t/should-we-have-templates-available-for-ansible-documentation/27/3 "2023-07-26T14:03:35Z")

</div>

Yeah this sounds like it should be part of that writer’s toolkit so +1 from me.

---

<div class="post-metadata">

**Author:** ![Spredzy](https://sea1.discourse-cdn.com/ansible/user_avatar/forum.ansible.com/spredzy/32/56_2.png) [@Spredzy](https://forum.ansible.com/u/Spredzy)\
**Post date:** [August 9, 2023, 8:15am UTC](https://forum.ansible.com/t/should-we-have-templates-available-for-ansible-documentation/27/4 "2023-08-09T08:15:41Z")

</div>

100% yes. Back in the Openstack Puppet community, we were providing a cookiecutter template for our puppet module, basically run that commands and you have a puppet module that does an hello world with all the opinionated practices that specific group followed.

It was really easy to start with and we’ve witnessed people coming to our IRC channel then, showing end to end working modules and asking for feedback.

The lower the entry barrier is to start anything, the better