From 89841278b5e917cf08e64b7b2d81b45ba389a606 Mon Sep 17 00:00:00 2001
From: Yuri Sizov <yuris@humnom.net>
Date: Tue, 3 Oct 2023 15:03:42 +0200
Subject: [PATCH] Update the state of C#/.NET support as of 4.2

---
 about/list_of_features.rst                       | 16 +++++++++++++---
 .../step_by_step/scripting_languages.rst         |  5 ++---
 tutorials/scripting/c_sharp/c_sharp_basics.rst   | 16 ++--------------
 3 files changed, 17 insertions(+), 20 deletions(-)

diff --git a/about/list_of_features.rst b/about/list_of_features.rst
index 653b3e0997a4..0ac7cd307b65 100644
--- a/about/list_of_features.rst
+++ b/about/list_of_features.rst
@@ -37,6 +37,12 @@ Platforms
 Godot aims to be as platform-independent as possible and can be
 :ref:`ported to new platforms <doc_custom_platform_ports>` with relative ease.
 
+.. note::
+
+    The C#/.NET version of Godot 4 only supports desktop platforms. Experimental support
+    for Android is available starting with Godot 4.2. iOS and web platform support is
+    currently in development.
+
 Editor
 ------
 
@@ -429,12 +435,16 @@ Scripting
 :ref:`C#: <toc-learn-scripting-C#>`
 
 - Packaged in a separate binary to keep file sizes and dependencies down.
-- Uses .NET 6.
+- Supports .NET 6 and 7.
 
    - Full support for the C# 10.0 syntax and features.
 
-- Supports Windows, Linux and macOS. Mobile/web platforms are currently
-  unsupported. To use C# on mobile/web platforms, use Godot 3 instead.
+- Supports Windows, Linux, and macOS. As of 4.2 experimental support for Android
+  is also available.
+
+   - iOS and web platforms are currently unsupported. To use C# on those platforms,
+     consider Godot 3 instead.
+
 - Using an external editor is recommended to benefit from IDE functionality.
 
 **GDExtension (C, C++, Rust, D, ...):**
diff --git a/getting_started/step_by_step/scripting_languages.rst b/getting_started/step_by_step/scripting_languages.rst
index 4dad51f8219a..eb102711e9f3 100644
--- a/getting_started/step_by_step/scripting_languages.rst
+++ b/getting_started/step_by_step/scripting_languages.rst
@@ -128,9 +128,8 @@ officially supported .NET option.
 
 .. attention::
 
-    Projects written in C# using Godot 4.x currently cannot be exported to
-    Android, iOS and web platforms. To use C# on those platforms, use Godot 3
-    instead.
+    Projects written in C# using Godot 4 currently cannot be exported to iOS
+    and web platforms. To use C# on those platforms, consider Godot 3 instead.
 
 C++ via GDExtension
 ~~~~~~~~~~~~~~~~~~~
diff --git a/tutorials/scripting/c_sharp/c_sharp_basics.rst b/tutorials/scripting/c_sharp/c_sharp_basics.rst
index ece4a27f8eb2..e67c47ccbd26 100644
--- a/tutorials/scripting/c_sharp/c_sharp_basics.rst
+++ b/tutorials/scripting/c_sharp/c_sharp_basics.rst
@@ -6,17 +6,6 @@ C# basics
 Introduction
 ------------
 
-.. warning::
-
-    .NET support has been heavily modified between Godot 3 and 4. As such, you
-    may still run into some issues, or find spots where the documentation could
-    be improved.
-
-    Please report issues with C# in Godot on the
-    `engine GitHub page <https://github.com/godotengine/godot/issues>`_,
-    and any documentation issues on the
-    `documentation GitHub page <https://github.com/godotengine/godot-docs/issues>`_.
-
 This page provides a brief introduction to C#, both what it is and
 how to use it in Godot. Afterwards, you may want to look at
 :ref:`how to use specific features <doc_c_sharp_features>`, read about the
@@ -29,9 +18,8 @@ it is implemented with .NET 6.0.
 
 .. attention::
 
-    Projects written in C# using Godot 4.x currently cannot be exported to
-    Android, iOS and web platforms. To use C# on those platforms, use Godot 3
-    instead.
+    Projects written in C# using Godot 4.x currently cannot be exported to iOS
+    and web platforms. To use C# on those platforms, consider Godot 3 instead.
 
 .. note::