# Building the documentation

**URL:** https://discuss.elastic.co/t/building-the-documentation/15210
**Category:** Elasticsearch
**Created:** [January 11, 2014, 8:01pm UTC](https://discuss.elastic.co/t/building-the-documentation/15210 "2014-01-11T20:01:52Z")
**Posts on this page:** 3
**Page:** 1

<div class="post-metadata">

### Author: ![Ivan](https://avatars.discourse-cdn.com/v4/letter/i/df788c/32.png) [@Ivan](https://discuss.elastic.co/u/Ivan)
#### Post date: [January 11, 2014, 8:01pm UTC](https://discuss.elastic.co/t/building-the-documentation/15210/1 "2014-01-11T20:01:52Z")

</div>

I have been accumulating a few documentation inconsistencies over the past  
several months and I wanted to finally fix them and contribute them back.  
Last time I made any changes was in the old markdown repository. I am  
referring to the documentation under the main project (  
[https://github.com/elasticsearch/elasticsearch/tree/master/docs](https://github.com/elasticsearch/elasticsearch/tree/master/docs)) not the  
new documentation repo ([https://github.com/elasticsearch/docs](https://github.com/elasticsearch/docs)).

How is the site asciidoc built? Since Github uses asciidoctor, I have tried  
using it, but I cannot come up with a way to create the same directory  
structure using the default stylesheets/templates, so there is obviously  
more to building the documents that what is included in git. Or am I  
missing something? My sole command line flag is ''-d book".

Cheers,

Ivan

--  
You received this message because you are subscribed to the Google Groups "elasticsearch" group.  
To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com).  
To view this discussion on the web visit [https://groups.google.com/d/msgid/elasticsearch/CALY%3DcQAY6VPkPobCKzZf3wgOFZa%3D\_UdVtotP%2Bd8kidiOLaKYsQ%40mail.gmail.com](https://groups.google.com/d/msgid/elasticsearch/CALY%3DcQAY6VPkPobCKzZf3wgOFZa%3D_UdVtotP%2Bd8kidiOLaKYsQ%40mail.gmail.com).  
For more options, visit [https://groups.google.com/groups/opt\_out](https://groups.google.com/groups/opt_out).

---

<div class="post-metadata">

### Author: ![Ivan](https://avatars.discourse-cdn.com/v4/letter/i/df788c/32.png) [@Ivan](https://discuss.elastic.co/u/Ivan)
#### Post date: [January 11, 2014, 8:39pm UTC](https://discuss.elastic.co/t/building-the-documentation/15210/2 "2014-01-11T20:39:10Z")

</div>

It seems I have misunderstood the intent of the new documentation repo and  
it is indeed what I am looking for. I assumed it was the WIP elasticsearch  
book. Asciidoc is fairly simple, not sure why this level of complexity is  
needed.

Cheers,

Ivan

On Sat, Jan 11, 2014 at 12:01 PM, Ivan Brusic [ivan@brusic.com](mailto:ivan@brusic.com) wrote:

> I have been accumulating a few documentation inconsistencies over the past  
> several months and I wanted to finally fix them and contribute them back.  
> Last time I made any changes was in the old markdown repository. I am  
> referring to the documentation under the main project (  
> [https://github.com/elasticsearch/elasticsearch/tree/master/docs](https://github.com/elasticsearch/elasticsearch/tree/master/docs)) not the  
> new documentation repo ([https://github.com/elasticsearch/docs](https://github.com/elasticsearch/docs)).
> 
> How is the site asciidoc built? Since Github uses asciidoctor, I have  
> tried using it, but I cannot come up with a way to create the same  
> directory structure using the default stylesheets/templates, so there is  
> obviously more to building the documents that what is included in git. Or  
> am I missing something? My sole command line flag is ''-d book".
> 
> Cheers,
> 
> Ivan

--  
You received this message because you are subscribed to the Google Groups "elasticsearch" group.  
To unsubscribe from this group and stop receiving emails from it, send an email to [elasticsearch+unsubscribe@googlegroups.com](mailto:elasticsearch+unsubscribe@googlegroups.com).  
To view this discussion on the web visit [https://groups.google.com/d/msgid/elasticsearch/CALY%3DcQBUuUinm%2BkwmNEwsMYViV\_KfPp1hR23prVyKN5O4chGhA%40mail.gmail.com](https://groups.google.com/d/msgid/elasticsearch/CALY%3DcQBUuUinm%2BkwmNEwsMYViV_KfPp1hR23prVyKN5O4chGhA%40mail.gmail.com).  
For more options, visit [https://groups.google.com/groups/opt\_out](https://groups.google.com/groups/opt_out).

---

<div class="post-metadata">

### Author: ![system](https://us1.discourse-cdn.com/elastic/original/3X/1/a/1ac57faf039f6b580b3f104ef42a2a89e41014de.png) [@system](https://discuss.elastic.co/u/system)
#### Post date: [July 6, 2017, 1:57am UTC](https://discuss.elastic.co/t/building-the-documentation/15210/3 "2017-07-06T01:57:15Z")

</div>


