In case it makes a difference, we're slowly getting rid of that folder structure in the elasticsearch repo and have already removed it from kibana. The "x-pack" content is now just mixed in with the rest.

My advice would be to leave the x-pack content in the regular docs folder, but if you do go this route of separation I think you'll need to make some additional changes:

1. Add a --resource parameter to your build command for master (e.g. similar to the docbldesx alias in https://github.com/elastic/docs/blob/master/doc_build_aliases.sh)
2. Add a separate build alias for 6.x and earlier releases, since they won't use that resource
3. If you don't already have it, you might also need to add an attribute that clarifies the path to that the two different directories, like the es-repo-dir and xes-repo-dir attributes here: https://raw.githubusercontent.com/elastic/elasticsearch/master/docs/reference/index.asciidoc

@lcawl Which of the changes listed above need to be made before this PR is merged? The Beats docs use relative paths right now in the include statements (not attributes). We should probably improve that, but it hasn't caused build issues so far.

@dedemorton If I remember correctly, the first errors you'll see will likely be related to files that have images in them.