Asciidoc Distributed Docs as Code

Question

Asciidoc Distributed Docs as Code - sheldonhull.com

Closed this issue 3 years ago · 6 comments

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

Answer 1 · 2020-06-26T12:37:22.000Z

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.

Answer 2 · 2020-06-26T15:54:22.000Z

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. 🍻

Answer 3 · 2020-06-30T08:28:58.000Z

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.

Answer 4 · 2020-06-30T08:41:49.000Z

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

Answer 5 · 2021-02-15T12:14:21.000Z

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.

Answer 6 · 2021-03-31T18:53:49.000Z

@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.