###### tags: `Documentation`

# Ansible-lint 2.3 docs

Conversion pipeline overview:

1. Synchronize MD from ansible/ansible-lint.
2. Convert MD to ADOC.
3. Push ADOC to downstream GitLab.

Once the converted ADOC is in GitLab we can hook it into publishing toolchain.

Converted asciidoc is available in this repository: https://github.com/ansible/aap-docs/tree/aap-2.3

This playbook runs in a GH action and does the sync and conversion: https://github.com/ansible/aap-docs/blob/aap-2.3/bin/lint_docs.yaml

You can perform the sync and conversion on the **Actions** tab here:


Here is a preview link of the asciidoc content: https://htmlpreview.github.io/?https://github.com/ansible/aap-docs/blob/aap-2.3/titles/ansible-lint/ansible-lint.html

The MD to ADOC conversion uses kramdown, which is part of the asciidoc toolchain.

https://github.com/asciidoctor/kramdown-asciidoc