Make SourceKit-LSP’s documentation more discoverable

Author: ahoppen

Documentation/README.md

@@ -0,0 +1,22 @@
+# Documentation
+
+## User Documentation
+
+The following documentation documents are primarily intended for users of SourceKit-LSP.
+
+- [Configuration File](Configuration%20File.md)
+- [Diagnose Bundle](Diagnose%20Bundle.md)
+- [Editor Integration](Editor%20Integration.md)
+- [Enable Experimental Background Indexing](Enable%20Experimental%20Background%20Indexing.md)
+- [Environment Variables](Environment%20Variables.md)
+
+## Developer Documentation
+
+The following documentation documents are primarily intended for developers of SourceKit-LSP.
+
+- [Files To Reindex](Files%20To%20Reindex.md)
+- [LSP Extensions](LSP%20Extensions.md)
+- [Logging](Logging.md)
+- [Modules](Modules.md)
+- [Overview](Overview.md)
+- [Testing](Testing.md)

README.md

@@ -6,13 +6,15 @@ SourceKit-LSP is an implementation of the [Language Server Protocol](https://mic
 
 https://www.swift.org/tools has a list of popular editors that support LSP and can thus be hooked up to SourceKit-LSP to provide intelligent editor functionality as well as set-up guides.
 
+> [!IMPORTANT]
+> SourceKit-LSP does not update its global index in the background or build Swift modules in the background. Thus, a lot of cross-module or global functionality is limited if the project hasn't been built recently. To update the index or rebuild the Swift modules, build your project or enable the experimental background indexing as described in [Enable Experimental Background Indexing](Documentation/Enable%20Experimental%20Background%20Indexing.md).
+
+To learn more about SourceKit-LSP, refer to the [Documentation](Documentation).
+
 ## Reporting Issues
 
 If you should hit any issues while using SourceKit-LSP, we appreciate bug reports on [GitHub Issue](https://github.com/swiftlang/sourcekit-lsp/issues/new/choose).
 
-> [!IMPORTANT]
-> SourceKit-LSP does not update its global index in the background or build Swift modules in the background. Thus, a lot of cross-module or global functionality is limited if the project hasn't been built recently. To update the index or rebuild the Swift modules, build the project.
-
 ## Contributing
 
 If you want to contribute code to SourceKit-LSP, see [CONTRIBUTING.md](CONTRIBUTING.md) for more information.