Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/thegeeklab/ansible-doctor

Annotation based documentation for your Ansible roles
https://github.com/thegeeklab/ansible-doctor

ansible automation documentation python

Last synced: about 2 months ago
JSON representation

Annotation based documentation for your Ansible roles

Host: GitHub
URL: https://github.com/thegeeklab/ansible-doctor
Owner: thegeeklab
License: gpl-3.0
Created: 2019-10-08T10:03:15.000Z (over 4 years ago)
Default Branch: main
Last Pushed: 2024-05-06T19:29:25.000Z (about 2 months ago)
Last Synced: 2024-05-07T01:32:29.103Z (about 2 months ago)
Topics: ansible, automation, documentation, python
Language: Python
Homepage: https://ansible-doctor.geekdocs.de
Size: 1.32 MB
Stars: 116
Watchers: 3
Forks: 18
Open Issues: 6
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Lists

awesome-ansible - Ansible Doctor - Simple annotation like documentation generator for Ansible roles based on Jinja2 templates. (Tools)
awesome-stars - thegeeklab/ansible-doctor - Annotation based documentation for your Ansible roles (Python)
my-awesome-stars - thegeeklab/ansible-doctor - Annotation based documentation for your Ansible roles (Python)
awesome-ansible - Ansible Doctor - Simple annotation like documentation generator for Ansible roles based on Jinja2 templates. (Tools)
ansible_awesome - Ansible Doctor - Simple annotation like documentation generator for Ansible roles based on Jinja2 templates. (Tools)

README

        # ansible-doctor

Annotation based documentation for your Ansible roles

[![Build Status](https://ci.thegeeklab.de/api/badges/thegeeklab/ansible-doctor/status.svg)](https://ci.thegeeklab.de/repos/thegeeklab/ansible-doctor)

[![Docker Hub](https://img.shields.io/badge/dockerhub-latest-blue.svg?logo=docker&logoColor=white)](https://hub.docker.com/r/thegeeklab/ansible-doctor)

[![Quay.io](https://img.shields.io/badge/quay-latest-blue.svg?logo=docker&logoColor=white)](https://quay.io/repository/thegeeklab/ansible-doctor)

[![Python Version](https://img.shields.io/pypi/pyversions/ansible-doctor.svg)](https://pypi.org/project/ansible-doctor/)

[![PyPI Status](https://img.shields.io/pypi/status/ansible-doctor.svg)](https://pypi.org/project/ansible-doctor/)

[![PyPI Release](https://img.shields.io/pypi/v/ansible-doctor.svg)](https://pypi.org/project/ansible-doctor/)

[![GitHub contributors](https://img.shields.io/github/contributors/thegeeklab/ansible-doctor)](https://github.com/thegeeklab/ansible-doctor/graphs/contributors)

[![Source: GitHub](https://img.shields.io/badge/source-github-blue.svg?logo=github&logoColor=white)](https://github.com/thegeeklab/ansible-doctor)

[![License: GPL-3.0](https://img.shields.io/github/license/thegeeklab/ansible-doctor)](https://github.com/thegeeklab/ansible-doctor/blob/main/LICENSE)

This project is based on the idea (and at some parts on the code) of [ansible-autodoc](https://github.com/AndresBott/ansible-autodoc) by Andres Bott so credits goes to him for his work.

_ansible-doctor_ is a simple annotation like documentation generator based on Jinja2 templates. While _ansible-doctor_ comes with a default template called `readme`, it is also possible to write custom templates to customize the output or render the data to other formats like HTML or XML as well.

_ansible-doctor_ is designed to work within a CI pipeline to complete the existing testing and deployment workflow. Releases are available as Python Packages on [GitHub](https://github.com/thegeeklab/ansible-doctor/releases) or [PyPI](https://pypi.org/project/ansible-doctor/) and as Docker Image on [Docker Hub](https://hub.docker.com/r/thegeeklab/ansible-doctor).

The full documentation is available at [https://ansible-doctor.geekdocs.de](https://ansible-doctor.geekdocs.de/).

## Contributors

Special thanks to all [contributors](https://github.com/thegeeklab/ansible-doctor/graphs/contributors). If you would like to contribute,

please see the [instructions](https://github.com/thegeeklab/ansible-doctor/blob/main/CONTRIBUTING.md).

## License

This project is licensed under the GPL-3.0 License - see the [LICENSE](https://github.com/thegeeklab/ansible-doctor/blob/main/LICENSE) file for details.