docs: Followup to the recent docs branch: clean up some internal cross-references.

README.md

@@ -45,5 +45,5 @@ How to tweak
 ------------
 
 Syntax highlighting is done by pluggable highlighter scripts.  See the
-[`highlighters` directory](./highlighters) for documentation and configuration
+[documentation on highlighters](docs/highlighters.md) for details and
-settings.
+configuration settings.

docs/highlighters.md

@@ -27,10 +27,11 @@ How to tweak highlighters
 -------------------------
 
 Highlighters look up styles from the `ZSH_HIGHLIGHT_STYLES` associative array.
-Navigate into each highlighter directory to see what styles (keys) it defines;
+Navigate into the [individual highlighters' documentation](highlighters/) to
-the syntax for values is the same as the syntax of "types of highlighting" of
+see what styles (keys) each highlighter defines; the syntax for values is the
-the zsh builtin `$zle_highlight` array, which is documented in [the `zshzle(1)`
+same as the syntax of "types of highlighting" of the zsh builtin
-manual page][zshzle-Character-Highlighting].
+`$zle_highlight` array, which is documented in [the `zshzle(1)` manual
+page][zshzle-Character-Highlighting].
 
 [zshzle-Character-Highlighting]: http://zsh.sourceforge.net/Doc/Release/Zsh-Line-Editor.html#Character-Highlighting
 

highlighters/README.md

@@ -1 +0,0 @@
-../docs/highlighters.md

highlighters/README.md

@@ -0,0 +1,8 @@
+zsh-syntax-highlighting / highlighters
+======================================
+
+Navigate into the individual highlighters' documentation to see
+what styles (`$ZSH_HIGHLIGHT_STYLES` keys) each highlighter defines.
+
+Refer to the [documentation on highlighters](../docs/highlighters.md) for further
+information.