Mark toml as experimental

Also minor extensions of comments and docstrings

README.md

@@ -68,7 +68,7 @@ than existing solutions that charge a premium.
 
 Language servers provide support for a wide range of programming languages.
 With Serena's LSP library, we provide **support for over 30 programming languages**, including
-AL, Bash, C#, C/C++, Clojure, Dart, Elixir, Elm, Erlang, Fortran, Go, Haskell, Java, Javascript, Julia, Kotlin, Lua, Markdown, Nix, Perl, PHP, PowerShell, Python, R, Ruby, Rust, Scala, Swift, TypeScript, YAML and Zig.
+AL, Bash, C#, C/C++, Clojure, Dart, Elixir, Elm, Erlang, Fortran, Go, Haskell, Java, Javascript, Julia, Kotlin, Lua, Markdown, Nix, Perl, PHP, PowerShell, Python, R, Ruby, Rust, Scala, Swift, TOML, TypeScript, YAML, and Zig.
 
 > [!IMPORTANT]
 > Some languages require additional dependencies to be installed; see the [Language Support](https://oraios.github.io/serena/01-about/020_programming-languages.html) page for details.

src/solidlsp/language_servers/taplo_server.py

@@ -167,6 +167,7 @@ class TaploServer(SolidLanguageServer):
     @classmethod
     def _download_taplo(cls, install_dir: str, executable_path: str) -> None:
         """Download and extract Taplo binary with SHA256 verification."""
+        # TODO: consider using existing download utilities in SolidLSP instead of the custom logic here
         download_url, _ = _get_taplo_download_url()
         archive_filename = os.path.basename(download_url)
 

src/solidlsp/ls_config.py

@@ -99,6 +99,10 @@ class Language(str, Enum):
     def is_experimental(self) -> bool:
         """
         Check if the language server is experimental or deprecated.
+
+        Note for serena users/developers:
+        Experimental languages are not autodetected and must be explicitly specified
+        in the project.yml configuration.
         """
         return self in {
             self.TYPESCRIPT_VTS,
@@ -107,6 +111,7 @@ class Language(str, Enum):
             self.RUBY_SOLARGRAPH,
             self.MARKDOWN,
             self.YAML,
+            self.TOML,
         }
 
     def __str__(self) -> str: