This repository contains the documentation for Open Distro for Elasticsearch, a full-featured, open source distribution of Elasticsearch for analytics workloads. You can find the rendered documentation at opendistro.github.io/for-elasticsearch-docs/.

1. Navigate to the repository root.

2. Install Ruby if you don't already have it.

3. Install Jekyll if you don't already have it:

   gem install bundler jekyll

4. Install dependencies:

   bundle install

5. Build:

   bundle exec jekyll serve

   Alternately, run build.sh, which includes some convenience flags and is faster to type.

   You'll probably receive a couple Invalid theme folder: _sass warnings from Jekyll. You can safely ignore them.

6. Open http://localhost:4000/for-elasticsearch-docs/.

1. Fork this repository.
2. Clone your fork.
3. Edit the Markdown files in /docs.
4. Use Jekyll to build the content, and make sure your changes render the way you expect.
5. Push your changes, and submit a pull request.

1. Try to stay consistent with existing content.
2. Introduce acronyms before using them.
3. Use bold for user interface elements, italics for key terms or emphasis, and monospace for Bash commands, file names, URIs, and code.
4. Markdown file names should be all lowercase, use hyphens to separate words, and end in .md.

This documentation uses a modified version of the just-the-docs Jekyll theme, which has some useful classes for labels and buttons:

[Get started](#get-started){: .btn .btn-blue }

## Get started
New
{: .label .label-green :}

• Labels come in default (blue), green, purple, yellow, and red.
• Buttons come in default, purple, blue, green, and outline.
• Warning, tip, and note blocks are available ({: .warning }, etc.).
• If an image has a white background, you can use {: .img-border } to add a one pixel border to the image.

These classes can help with readability, but should be used sparingly. Each addition of a class damages the portability of the Markdown files and makes moving to a different Jekyll theme (or a different static site generator) more difficult.

Besides, standard Markdown elements suffice for most documentation.

To create an auto-generated table of contents near the top of long pages, use the following snippet:

#### Table of contents
1. TOC
{:toc}

By design, only h2 and h3 headers are included.

If you create a new directory, name its first file index.md and make it a parent so that the links stay pretty:

---
layout: default
title: Some New Page
nav_order: 4
has_children: true
has_toc: false
---

This project has adopted an Open Source Code of Conduct.

If you discover a potential security issue in this project we ask that you notify AWS/Amazon Security via our vulnerability reporting page. Please do not create a public GitHub issue.

See the LICENSE file for our project's licensing. We will ask you to confirm the licensing of your contribution.

Copyright 2019 Amazon.com, Inc. or its affiliates. All rights reserved.