refactor: rename "server_configurations" => "configs" #3330

Problem:
The name `server_configurations` is extremely verbose and irritatingly
formal and dogmatic. This overlong name is a constant nuisance when
reading, writing, and coding.

It's also not even correct: these configurations are just as much
"client" configurations as they are "server" configurations.

Solution:
- Rename to a shorter name.
- Leave placeholder files for any old URLs that link to the old
  location.

1 files changed, 47 insertions, 0 deletions

diff --git a/lua/lspconfig/configs/terraformls.lua b/lua/lspconfig/configs/terraformls.lua
new file mode 100644
index 00000000..9326b9b1
--- /dev/null
+++ b/lua/lspconfig/configs/terraformls.lua
@@ -0,0 +1,47 @@
+local util = require 'lspconfig.util'
+
+return {
+  default_config = {
+    cmd = { 'terraform-ls', 'serve' },
+    filetypes = { 'terraform', 'terraform-vars' },
+    root_dir = util.root_pattern('.terraform', '.git'),
+  },
+  docs = {
+    description = [[
+https://github.com/hashicorp/terraform-ls
+
+Terraform language server
+Download a released binary from https://github.com/hashicorp/terraform-ls/releases.
+
+From https://github.com/hashicorp/terraform-ls#terraform-ls-vs-terraform-lsp:
+
+Both HashiCorp and the maintainer of terraform-lsp expressed interest in
+collaborating on a language server and are working towards a _long-term_
+goal of a single stable and feature-complete implementation.
+
+For the time being both projects continue to exist, giving users the
+choice:
+
+- `terraform-ls` providing
+  - overall stability (by relying only on public APIs)
+  - compatibility with any provider and any Terraform >=0.12.0 currently
+    less features
+  - due to project being younger and relying on public APIs which may
+    not offer the same functionality yet
+
+- `terraform-lsp` providing
+  - currently more features
+  - compatibility with a single particular Terraform (0.12.20 at time of writing)
+    - configs designed for other 0.12 versions may work, but interpretation may be inaccurate
+  - less stability (due to reliance on Terraform's own internal packages)
+
+Note, that the `settings` configuration option uses the `workspace/didChangeConfiguration` event,
+[which is not supported by terraform-ls](https://github.com/hashicorp/terraform-ls/blob/main/docs/features.md).
+Instead you should use `init_options` which passes the settings as part of the LSP initialize call
+[as is required by terraform-ls](https://github.com/hashicorp/terraform-ls/blob/main/docs/SETTINGS.md#how-to-pass-settings).
+]],
+    default_config = {
+      root_dir = [[root_pattern(".terraform", ".git")]],
+    },
+  },
+}