# What tool is used for the "guide"
**URL:** https://discuss.elastic.co/t/what-tool-is-used-for-the-guide/202378
**Category:** Elastic Training
**Created:** [October 4, 2019, 7:10pm UTC](https://discuss.elastic.co/t/what-tool-is-used-for-the-guide/202378 "2019-10-04T19:10:17Z")
**Posts on this page:** 5
**Page:** 1
### Author:  [@haroutk](https://discuss.elastic.co/u/haroutk)
#### Post date: [October 4, 2019, 7:10pm UTC](https://discuss.elastic.co/t/what-tool-is-used-for-the-guide/202378/1 "2019-10-04T19:10:18Z")
Elastic has great docs with all the previous versions and the ability to edit an article and make a PR, multi-lang support...
( [https://www.elastic.co/guide/en/elastic-stack-get-started/current/index.html](https://www.elastic.co/guide/en/elastic-stack-get-started/current/index.html) )
anyways, just wondering if anyone knows what too(s) Elastic is using for their online guide/documentation
thanks
---
### Author:  [@pmusa](https://discuss.elastic.co/u/pmusa)
#### Post date: [October 4, 2019, 7:13pm UTC](https://discuss.elastic.co/t/what-tool-is-used-for-the-guide/202378/2 "2019-10-04T19:13:15Z")
Hi haroutk,
we are using a mix of tools to create and automate docs. The [asciidoctor](https://asciidoctor.org/) is one of the main ones. As all the code is open you can browse any of the projects and check how we do it.
Cheers
---
### Author:  [@haroutk](https://discuss.elastic.co/u/haroutk)
#### Post date: [October 4, 2019, 7:52pm UTC](https://discuss.elastic.co/t/what-tool-is-used-for-the-guide/202378/3 "2019-10-04T19:52:42Z")
Thanks for the quick reply. other than asciidocotr, what other tools/software are u using?
---
### Author:  [@nik9000](https://discuss.elastic.co/u/nik9000)
#### Post date: [October 4, 2019, 9:08pm UTC](https://discuss.elastic.co/t/what-tool-is-used-for-the-guide/202378/4 "2019-10-04T21:08:47Z")
We use a home grown [perl](https://github.com/elastic/docs/) script for managing the process.
We're in the process of migrating from [Asciidoc](https://www.methods.co.nz/asciidoc/) to [AsciiDoctor](https://asciidoctor.org/) because Asciidoc is no longer maintained. Asciidoc is also about 100x slower.
Either way, we convert the Asciidoc file to docbook and use [Docbook](https://docbook.org/) to convert the docbook XML file into HTML. This is fairly time consuming because all of the docbook translations are implemented as XSLT. Which is slow. And soul crushing to extend of debug. So, eventually, we'll migrate from docbook to outputting HTML directly.
We use [Parcel](https://parceljs.org/) to wrangle our web resources.
It's pretty much the unix way: lots of little pieces all plugged together.
But we've spent a while customizing Asciidoctor to make it work how we need it to. It is nice to work with.
We looked at [Antora](https://antora.org/) and it looked great but it also looked time consuming to get from what we have to using it. Still, it is totally worth looking at.
---
### Author:  [@system](https://discuss.elastic.co/u/system)
#### Post date: [November 3, 2019, 9:08pm UTC](https://discuss.elastic.co/t/what-tool-is-used-for-the-guide/202378/5 "2019-11-03T21:08:53Z")
This topic was automatically closed 30 days after the last reply. New replies are no longer allowed.