Move dml_compile_commands explanation to README

Author: JonatanWaern

CONTRIBUTING.md

@@ -203,24 +203,4 @@ particular order:
 - The folder of B
 - The root folder of the workspace
 - All other workspace roots
-- Every include path specified by the [DML Compile commands](#dml-compile-commands) under the related module
-
-#### <a id="dml-compile-commands"></a> DML Compile Commands
-The DML compile commands file is used by the DLS in order to obtain per-module
-information used to resolve imports and specify options for specific devices.
-
-Commonly this will be auto-generated by the CMake indexing in your Simics
-project, but it is possible to construct such a file by hand if absolutely
-neccessary. It is a json file with the following format:
-```
-{
-  <full path to device file>: {
-    "includes": [<include folders as full paths>],
-    "dmlc_flags: [<flags passed to dmlc invocation>]
-  },
-  ... <more device paths>
-}
-```
-
-This will add the include folders specified when analysing files included,
-directly or indirectly, from the specified device file.
+- Every include path specified by the [DML Compile commands](README.md#dml-compile-commands) under the related module

README.md

@@ -32,3 +32,25 @@ is not yet publicly available.
 
 See [clients.md](clients.md) for information about how to implement
 your own language client compatible with the DML language server.
+
+## <a id="dml-compile-commands"></a> DML Compile Commands
+The DML compile commands file is used by the language server in order to obtain
+per-module information used to resolve imports and obtain relevant command-line
+DMLC flags for specific devices.
+
+Commonly this will be auto-generated by the CMake indexing in your Simics
+project (you may need to specify the environment variable "CMAKE_EXPORT_COMPILE_COMMANDS=1"
+before invoking cmake), but it is possible to construct such a file by hand if absolutely
+neccessary. It is a json file with the following format:
+```
+{
+  <full path to device file>: {
+    "includes": [<include folders as full paths>],
+    "dmlc_flags: [<flags passed to dmlc invocation>]
+  },
+  ... <more device paths>
+}
+```
+
+This will add the include folders specified when analysing files included,
+directly or indirectly, from the specified device file.