Update README

filmor · filmor · commit 3c4dd1680fa4 · 2022-09-26T02:33:22.000+02:00
diff --git a/README.rst b/README.rst
@@ -17,11 +17,6 @@ provides a powerful application scripting tool for .NET developers. It
 allows Python code to interact with the CLR, and may also be used to
 embed Python into a .NET application.
 
-.. note::
-   The master branch of this repository tracks the ongoing development of version 3.0.
-   Backports of patches to 2.5 are tracked in the
-   `backports-2.5 branch <https://github.com/pythonnet/pythonnet/tree/backports-2.5>`_.
-
 Calling .NET code from Python
 -----------------------------
 
@@ -42,6 +37,25 @@ module:
    clr.AddReference("System.Windows.Forms")
    from System.Windows.Forms import Form
 
+By default, Mono will be used on Linux and macOS, .NET Framework on Windows. For
+details on the loading of different runtimes, please refer to the documentation.
+
+.NET Core
+~~~~~~~~~
+
+If .NET Core is installed in a default location or the ``dotnet`` CLI tool is on
+the ``PATH``, loading it instead of the default (Mono/.NET Framework) runtime
+just requires setting either the environment variable
+``PYTHONNET_RUNTIME=coreclr`` or calling ``pythonnet.load`` explicitly:
+
+.. code-block:: python
+
+   from pythonnet import load
+   load("coreclr")
+
+   import clr
+
+
 Embedding Python in .NET
 ------------------------
 
diff --git a/doc/source/python.rst b/doc/source/python.rst
@@ -95,7 +95,8 @@ The equivalent configuration to the ``load`` example would be
    PYTHONNET_CORECLR_RUNTIME_CONFIG=/path/to/runtimeconfig.json
 
 .. note::
-   Only string parameters are supported this way.
+   Only string parameters are supported this way. It has the advantage, though,
+   that the same configuration will be used for subprocesses as well.
 
 Constructing a ``Runtime`` instance
 ...................................
