Improved documentation

Author: sohaibiftikhar

docs/reference/analysis/tokenfilters/synonym-graph-tokenfilter.asciidoc

@@ -88,8 +88,11 @@ PUT /test_index
 --------------------------------------------------
 // CONSOLE
 With the above request the word `bar` gets skipped but a mapping `foo => baz` is still added. However, if the mapping
-being added was "foo, baz => bar" or "bar, foo, baz" nothing would get added to the synonym list. This is because the
-target word for the mapping is itself eliminated because it was a stop word.
+being added was "foo, baz => bar" nothing would get added to the synonym list. This is because the target word for the
+mapping is itself eliminated because it was a stop word. Similarly, if the mapping was "bar, foo, baz" and `expand` was
+set to `false` no mapping would get added as when `expand=false` the target mapping is the first word. However, if
+`expand=true` then the mappings added would be equivalent to `foo, baz => foo, baz` i.e, all mappings other than the
+stop word.
 
 [float]
 ==== `tokenizer` and `ignore_case` are deprecated

docs/reference/analysis/tokenfilters/synonym-tokenfilter.asciidoc

@@ -75,8 +75,11 @@ PUT /test_index
 --------------------------------------------------
 // CONSOLE
 With the above request the word `bar` gets skipped but a mapping `foo => baz` is still added. However, if the mapping
-being added was "foo, baz => bar" or "bar, foo, baz" nothing would get added to the synonym list. This is because the
-target word for the mapping is itself eliminated because it was a stop word.
+being added was "foo, baz => bar" nothing would get added to the synonym list. This is because the target word for the
+mapping is itself eliminated because it was a stop word. Similarly, if the mapping was "bar, foo, baz" and `expand` was
+set to `false` no mapping would get added as when `expand=false` the target mapping is the first word. However, if
+`expand=true` then the mappings added would be equivalent to `foo, baz => foo, baz` i.e, all mappings other than the
+stop word.
 
 
 [float]