Asciidoc Distributed Docs as Code - sheldonhull.com

[utterances-bot]

Asciidoc Distributed Docs as Code

https://www.sheldonhull.com/blog/asciidoc-distributed-docs-as-code/

[vishalkrsinha]

Hi There, I started to explore AsciiDoctor & Azure Devops Build Pipeline together. My first requirement is to simply setup ASCIIDOCTOR to Azure Devops Build Pipeline. Kindly guide me here in simple steps with an example please.

[sheldonhull]

Did you see the blog article gist? It contains an example of doing this. If you can provide more clarity on exactly where you are stuck it would help. 🍻

[sheldonhull]

Closing the related issue, but feel free to comment again if you can provide more detail on what you got stuck on and I'd be glad to point you in the right direction.

[vishalkrsinha]

Sure, sorry missed to reply. I'll update, once getting more clear specifications.

[InfernoZeus]

I saw your recent post on the kovetskiy/mark project. I wondered if you were looking to move away from this Asciidoc toolchain, and if so, why? I'm looking for a solution to exactly the same problems as you, and trying to decide between these two toolchains.

[sheldonhull]

@InfernoZeus I still think it's great. The only challenge I face is that adoption of asciidoc can be a barrier if folks are not already comfortable with docs as code approach. It is a bit more formal, though fantastic for a project to sync to confluence.

Markdown is more universal, so I stick with that mostly, though I prefer asciidoc.