Clarify install/ sub-directory role, or integrate it into HLS project

[sir4ur0n]

Contributing guidelines explain:

Note: the ./install/ folder is not directly tied to the project so it has dedicated ./install/hie.yaml.[cbl|stack] templates.

But this leads to several questions:

• Why isn't the install/ folder treated as another package of the root directory HLS project? It would make everything (build, HIE/HLS integration, etc.) simpler, wouldn't it?
• What is the purpose of this sub-directory? There is no README.md in that directory, and I couldn't find any documentation about it. Based on the description in install/hls-install.cabal I guess it's about installing HLS (for users? for something else?) but this limited information 😅

[jneira]

Why isn't the install/ folder treated as another package of the root directory HLS project? It would make everything (build, HIE/HLS integration, etc.) simpler, wouldn't it?

The reason is we want isolate install builds from hls ones. If it would be integrated the normal build could be broken or altered by install specific dependencies (or viceversa), cabal install all would install the package, etc

What is the purpose of this sub-directory? There is no README.md in that directory, and I couldn't find any documentation about it. Based on the description in install/hls-install.cabal I guess it's about installing HLS (for users? for something else?) but this limited information sweat_smile

This directory/subproject is needed for make work the install script in the root directory: https://github.com/haskell/haskell-language-server/blob/master/install.hs
It purpose is install hls for advanced users/maintainers.
But nowadays ghcup has support for build hls from source so i am not sure if it makes sense anymore tbh.

It is somewhat documented in the official docs: https://haskell-language-server.readthedocs.io/en/latest/installation.html#building
But a readme in the subfolder with a short summary and a link to docs would be great for sure, prs welcome!