docs: cleanup

- brief should live at the top of each file
- fix indentation for some docs

1 files changed, 27 insertions, 26 deletions

diff --git a/lsp/intelephense.lua b/lsp/intelephense.lua
index 13f7fd06..9910e207 100644
--- a/lsp/intelephense.lua
+++ b/lsp/intelephense.lua
@@ -1,31 +1,32 @@
-local util = require 'lspconfig.util'
-
 ---@brief
 ---
--- https://intelephense.com/
---
--- `intelephense` can be installed via `npm`:
--- ```sh
--- npm install -g intelephense
--- ```
---
--- ```lua
--- -- See https://github.com/bmewburn/intelephense-docs/blob/master/installation.md#initialisation-options
--- init_options = {
---   storagePath = …, -- Optional absolute path to storage dir. Defaults to os.tmpdir().
---   globalStoragePath = …, -- Optional absolute path to a global storage dir. Defaults to os.homedir().
---   licenceKey = …, -- Optional licence key or absolute path to a text file containing the licence key.
---   clearCache = …, -- Optional flag to clear server state. State can also be cleared by deleting {storagePath}/intelephense
--- }
--- -- See https://github.com/bmewburn/intelephense-docs
--- settings = {
---   intelephense = {
---     files = {
---       maxSize = 1000000;
---     };
---   };
--- }
--- ```
+--- https://intelephense.com/
+---
+--- `intelephense` can be installed via `npm`:
+--- ```sh
+--- npm install -g intelephense
+--- ```
+---
+--- ```lua
+--- -- See https://github.com/bmewburn/intelephense-docs/blob/master/installation.md#initialisation-options
+--- init_options = {
+---   storagePath = …, -- Optional absolute path to storage dir. Defaults to os.tmpdir().
+---   globalStoragePath = …, -- Optional absolute path to a global storage dir. Defaults to os.homedir().
+---   licenceKey = …, -- Optional licence key or absolute path to a text file containing the licence key.
+---   clearCache = …, -- Optional flag to clear server state. State can also be cleared by deleting {storagePath}/intelephense
+--- }
+--- -- See https://github.com/bmewburn/intelephense-docs
+--- settings = {
+---   intelephense = {
+---     files = {
+---       maxSize = 1000000;
+---     };
+---   };
+--- }
+--- ```
+
+local util = require 'lspconfig.util'
+
 return {
   cmd = { 'intelephense', '--stdio' },
   filetypes = { 'php' },