From 5783b63bd6c1be2e8d212e68b818eb4701c196bd Mon Sep 17 00:00:00 2001
From: James Rodewig <james.rodewig@elastic.co>
Date: Thu, 2 Jul 2020 09:52:14 -0400
Subject: [PATCH] [DOCS] Fix headings for simple analyzer docs (#58910)
 (#58919)

---
 .../analyzers/simple-analyzer.asciidoc        | 67 +++++++++----------
 1 file changed, 31 insertions(+), 36 deletions(-)

diff --git a/docs/reference/analysis/analyzers/simple-analyzer.asciidoc b/docs/reference/analysis/analyzers/simple-analyzer.asciidoc
index 36666d5087b27..1fedbfa344c0e 100644
--- a/docs/reference/analysis/analyzers/simple-analyzer.asciidoc
+++ b/docs/reference/analysis/analyzers/simple-analyzer.asciidoc
@@ -4,25 +4,25 @@
 <titleabbrev>Simple</titleabbrev>
 ++++
 
-The `simple` analyzer breaks text into terms whenever it encounters a
-character which is not a letter. All terms are lower cased.
+The `simple` analyzer breaks text into tokens at any non-letter character, such
+as numbers, spaces, hyphens and apostrophes, discards non-letter characters, 
+and changes uppercase to lowercase.
 
-[float]
-=== Example output
+[[analysis-simple-analyzer-ex]]
+==== Example
 
 [source,console]
----------------------------
+----
 POST _analyze
 {
   "analyzer": "simple",
   "text": "The 2 QUICK Brown-Foxes jumped over the lazy dog's bone."
 }
----------------------------
-
-/////////////////////
+----
 
+////
 [source,console-result]
-----------------------------
+----
 {
   "tokens": [
     {
@@ -104,52 +104,47 @@ POST _analyze
     }
   ]
 }
-----------------------------
-
-/////////////////////
-
+----
+////
 
-The above sentence would produce the following terms:
+The `simple` analyzer parses the sentence and produces the following 
+tokens: 
 
 [source,text]
----------------------------
+----
 [ the, quick, brown, foxes, jumped, over, the, lazy, dog, s, bone ]
----------------------------
+----
 
-[float]
-=== Configuration
+[[analysis-simple-analyzer-definition]]
+==== Definition
 
-The `simple` analyzer is not configurable.
-
-[float]
-=== Definition
-
-The `simple` analzyer consists of:
+The `simple` analyzer is defined by one tokenizer:
 
 Tokenizer::
-* <<analysis-lowercase-tokenizer,Lower Case Tokenizer>>
+* <<analysis-lowercase-tokenizer, Lowercase Tokenizer>>
+
+[[analysis-simple-analyzer-customize]]
+==== Customize
 
-If you need to customize the `simple` analyzer then you need to recreate
-it as a `custom` analyzer and modify it, usually by adding token filters.
-This would recreate the built-in `simple` analyzer and you can use it as
-a starting point for further customization:
+To customize the `simple` analyzer, duplicate it to create the basis for 
+a custom analyzer. This custom analyzer can be modified as required, usually by 
+adding token filters.
 
 [source,console]
-----------------------------------------------------
-PUT /simple_example
+----
+PUT /my_index
 {
   "settings": {
     "analysis": {
       "analyzer": {
-        "rebuilt_simple": {
+        "my_custom_simple_analyzer": {
           "tokenizer": "lowercase",
-          "filter": [         <1>
+          "filter": [                          <1>
           ]
         }
       }
     }
   }
 }
-----------------------------------------------------
-// TEST[s/\n$/\nstartyaml\n  - compare_analyzers: {index: simple_example, first: simple, second: rebuilt_simple}\nendyaml\n/]
-<1> You'd add any token filters here.
+----
+<1> Add token filters here.
\ No newline at end of file