feat(docs): autogenerate default_config docs

Problem:
Docs are manually maintained everywhere for no good reason.

Solution:
- revert commit 9dc02492c4a457479f8a0ec7a65aac1852ff59c0
- provide a "gF" friendly link to the source

1 files changed, 4 insertions, 2 deletions

diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 979ff78b..212788a0 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -29,9 +29,11 @@ To add a new language server, start with a minimal skeleton. See `:help lspconfi
 
 When choosing a config name, convert dashes (`-`) to underscores (`_`). If the name of the server is a unique name (`pyright`, `clangd`) or a commonly used abbreviation (`zls`), prefer this as the server name. If the server instead follows the pattern x-language-server, prefer the convention `x_ls` (`jsonnet_ls`). 
 
-Populate the `config` table with a `default_config` and `docs` table.
+Populate the `config` table with `default_config` and `docs` tables. Avoid over-architected code. Put lists directly in
+the `default_config` don't add indirection by defining variables elsewhere in the module. The docs are auto-generated by
+reading your `config` source code, so the less indirection in your code, the more useful and obvious the docs will be.
 
-`default_config` should include at minimum:
+`default_config` should include:
 
 * `cmd`: a list which includes the executable name as the first entry, with arguments constituting subsequent list elements (`--stdio` is common).
   ```lua