docs: cleanup

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

1 files changed, 18 insertions, 17 deletions

diff --git a/lsp/kotlin_language_server.lua b/lsp/kotlin_language_server.lua
index 950ef017..661822e5 100644
--- a/lsp/kotlin_language_server.lua
+++ b/lsp/kotlin_language_server.lua
@@ -1,3 +1,21 @@
+---@brief
+---
+--- A kotlin language server which was developed for internal usage and
+--- released afterwards. Maintaining is not done by the original author,
+--- but by fwcd.
+---
+--- It is built via gradle and developed on github.
+--- Source and additional description:
+--- https://github.com/fwcd/kotlin-language-server
+---
+--- This server requires vim to be aware of the kotlin-filetype.
+--- You could refer for this capability to:
+--- https://github.com/udalov/kotlin-vim (recommended)
+--- Note that there is no LICENSE specified yet.
+---
+--- For faster startup, you can setup caching by specifying a storagePath
+--- in the init_options. The default is your home directory.
+
 local util = require 'lspconfig.util'
 
 local bin_name = 'kotlin-language-server'
@@ -16,23 +34,6 @@ local root_files = {
   'build.gradle.kts', -- Gradle
 }
 
----@brief
----
----A kotlin language server which was developed for internal usage and
--- released afterwards. Maintaining is not done by the original author,
--- but by fwcd.
-
--- It is built via gradle and developed on github.
--- Source and additional description:
--- https://github.com/fwcd/kotlin-language-server
-
--- This server requires vim to be aware of the kotlin-filetype.
--- You could refer for this capability to:
--- https://github.com/udalov/kotlin-vim (recommended)
--- Note that there is no LICENSE specified yet.
-
--- For faster startup, you can setup caching by specifying a storagePath
--- in the init_options. The default is your home directory.
 return {
   filetypes = { 'kotlin' },
   root_markers = root_files,