From 7cbce4374f03418f03a5483a5759de98b9e269c8 Mon Sep 17 00:00:00 2001
From: Casey Rodarmor <casey@rodarmor.com>
Date: Wed, 24 Mar 2021 18:29:16 -0700
Subject: [PATCH] Reorganize readme to highlight editor support (#764)

---
 README.adoc | 105 +++++++++++++++++++++++++++-------------------------
 1 file changed, 54 insertions(+), 51 deletions(-)

diff --git a/README.adoc b/README.adoc
index 9363e9a..e61e1fd 100644
--- a/README.adoc
+++ b/README.adoc
@@ -138,6 +138,60 @@ You can use the following command on Linux, MacOS, or Windows to download the la
 curl --proto '=https' --tlsv1.2 -sSf https://just.systems/install.sh | bash -s -- --to DEST
 ```
 
+== Editor Support
+
+`justfile` syntax is close enough to `make` that you may want to tell your editor to use make syntax highlighting for just.
+
+=== Vim
+
+For vim, you can put the following in `~/.vim/filetype.vim`:
+
+```vimscript
+if exists("did_load_filetypes")
+  finish
+endif
+
+augroup filetypedetect
+  au BufNewFile,BufRead justfile setf make
+augroup END
+```
+
+You can add the following to a individual justfile to enable make mode on a per-file basis:
+
+```
+# vim: set ft=make :
+```
+
+=== Emacs
+
+There is a MELPA package, https://melpa.org/#/just-mode[just-mode], for automatic Emacs syntax highlighting and automatic indentation in justfiles.
+
+You can add the following to a individual justfile to enable make mode on a per-file basis:
+
+```
+# Local Variables:
+# mode: makefile
+# End:
+```
+
+=== Visual Studio Code
+
+An extension for VS Code by https://github.com/skellock[skellock] is https://marketplace.visualstudio.com/items?itemName=skellock.just[available here]. (https://github.com/skellock/vscode-just[repository])
+
+You can install it from the command line by running:
+
+```
+code --install-extension skellock.just
+```
+
+=== Kakoune
+
+Kakoune supports `justfile` syntax highlighting out of the box, thanks to TeddyDD.
+
+=== Other Editors
+
+Feel free to send me the commands necessary to get syntax highlighting working in your editor of choice so that I may include them here.
+
 == Quick Start
 
 See xref:Installation[] for how to install `just` on your computer. Try running `just --version` to make sure that it's installed correctly.
@@ -1267,57 +1321,6 @@ The `just` binary can also generate the same completion scripts at runtime, usin
 $ just --completions zsh > just.zsh
 ```
 
-=== Syntax Highlighting
-
-`justfile` syntax is close enough to `make` that you may want to tell your editor to use make syntax highlighting for just.
-
-==== Vim
-
-For vim, you can put the following in `~/.vim/filetype.vim`:
-
-```vimscript
-if exists("did_load_filetypes")
-  finish
-endif
-
-augroup filetypedetect
-  au BufNewFile,BufRead justfile setf make
-augroup END
-```
-
-==== Emacs
-
-There is a MELPA package, https://melpa.org/#/just-mode[just-mode], for automatic Emacs syntax highlighting and automatic indentation in justfiles.
-
-==== Vim and Emacs using Makefile mode
-
-Include the following in a `justfile` to use Makefile syntax highlighting in vim and emacs:
-
-```
-# Local Variables:
-# mode: makefile
-# End:
-# vim: set ft=make :
-```
-
-==== Visual Studio Code
-
-An extension for VS Code by https://github.com/skellock[skellock] is https://marketplace.visualstudio.com/items?itemName=skellock.just[available here]. (https://github.com/skellock/vscode-just[repository])
-
-You can install it from the command line by running:
-
-```
-code --install-extension skellock.just
-```
-
-==== Kakoune
-
-Kakoune supports `justfile` syntax highlighting out of the box, thanks to TeddyDD.
-
-==== Other Editors
-
-Feel free to send me the commands necessary to get syntax highlighting working in your editor of choice so that I may include them here.
-
 === Grammar
 
 A non-normative grammar of justfiles can be found in link:GRAMMAR.md[].