# ansible-doctor
Annotation based documentation for your Ansible roles
[](https://ci.thegeeklab.de/repos/thegeeklab/ansible-doctor)
[](https://hub.docker.com/r/thegeeklab/ansible-doctor)
[](https://quay.io/repository/thegeeklab/ansible-doctor)
[](https://pypi.org/project/ansible-doctor/)
[](https://pypi.org/project/ansible-doctor/)
[](https://pypi.org/project/ansible-doctor/)
[](https://github.com/thegeeklab/ansible-doctor/graphs/contributors)
[](https://github.com/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.
Raw data
{
"_id": null,
"home_page": "https://ansible-doctor.geekdocs.de/",
"name": "ansible-doctor",
"maintainer": null,
"docs_url": null,
"requires_python": "<4.0.0,>=3.10.0",
"maintainer_email": null,
"keywords": "ansible, role, documentation",
"author": "Robert Kaussow",
"author_email": "mail@thegeeklab.de",
"download_url": "https://files.pythonhosted.org/packages/1d/dd/a26d5d2781bd9de9a7a115ffce7f131153cc1db070a8e235a8b07f9c4e3f/ansible_doctor-7.1.0.tar.gz",
"platform": null,
"description": "# ansible-doctor\n\nAnnotation based documentation for your Ansible roles\n\n[](https://ci.thegeeklab.de/repos/thegeeklab/ansible-doctor)\n[](https://hub.docker.com/r/thegeeklab/ansible-doctor)\n[](https://quay.io/repository/thegeeklab/ansible-doctor)\n[](https://pypi.org/project/ansible-doctor/)\n[](https://pypi.org/project/ansible-doctor/)\n[](https://pypi.org/project/ansible-doctor/)\n[](https://github.com/thegeeklab/ansible-doctor/graphs/contributors)\n[](https://github.com/thegeeklab/ansible-doctor)\n[](https://github.com/thegeeklab/ansible-doctor/blob/main/LICENSE)\n\nThis 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.\n\n_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.\n\n_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).\n\nThe full documentation is available at [https://ansible-doctor.geekdocs.de](https://ansible-doctor.geekdocs.de/).\n\n## Contributors\n\nSpecial thanks to all [contributors](https://github.com/thegeeklab/ansible-doctor/graphs/contributors). If you would like to contribute,\nplease see the [instructions](https://github.com/thegeeklab/ansible-doctor/blob/main/CONTRIBUTING.md).\n\n## License\n\nThis project is licensed under the GPL-3.0 License - see the [LICENSE](https://github.com/thegeeklab/ansible-doctor/blob/main/LICENSE) file for details.\n",
"bugtrack_url": null,
"license": "GPL-3.0-only",
"summary": "Generate documentation from annotated Ansible roles using templates.",
"version": "7.1.0",
"project_urls": {
"Documentation": "https://ansible-doctor.geekdocs.de/",
"Homepage": "https://ansible-doctor.geekdocs.de/",
"Repository": "https://github.com/thegeeklab/ansible-doctor/"
},
"split_keywords": [
"ansible",
" role",
" documentation"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "c087ae6b70a89bd8c5bc194d375dba9d1d1508724bff64747cbf28975c646a3e",
"md5": "7a52ec3d71a38eb31b7afc744ecad25c",
"sha256": "9e2b0d161c95a8b1bede60c508a13cf46f0645735a1609ad551c17c3908f0e16"
},
"downloads": -1,
"filename": "ansible_doctor-7.1.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "7a52ec3d71a38eb31b7afc744ecad25c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4.0.0,>=3.10.0",
"size": 37072,
"upload_time": "2025-07-29T08:32:57",
"upload_time_iso_8601": "2025-07-29T08:32:57.549853Z",
"url": "https://files.pythonhosted.org/packages/c0/87/ae6b70a89bd8c5bc194d375dba9d1d1508724bff64747cbf28975c646a3e/ansible_doctor-7.1.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "1ddda26d5d2781bd9de9a7a115ffce7f131153cc1db070a8e235a8b07f9c4e3f",
"md5": "4d53829b966705c28117f9f444af95d6",
"sha256": "2795edecaa3854620fc2f2471569eee7c2a5dcaa068bdfafd814e3e7f28ed79e"
},
"downloads": -1,
"filename": "ansible_doctor-7.1.0.tar.gz",
"has_sig": false,
"md5_digest": "4d53829b966705c28117f9f444af95d6",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4.0.0,>=3.10.0",
"size": 28063,
"upload_time": "2025-07-29T08:32:58",
"upload_time_iso_8601": "2025-07-29T08:32:58.824408Z",
"url": "https://files.pythonhosted.org/packages/1d/dd/a26d5d2781bd9de9a7a115ffce7f131153cc1db070a8e235a8b07f9c4e3f/ansible_doctor-7.1.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-29 08:32:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "thegeeklab",
"github_project": "ansible-doctor",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "ansible-doctor"
}
JSON
