Update and improve documentation (#1256)

Author: AnErrupTion

Source/Docs/a-dive-into-baremetal.rst

@@ -198,7 +198,7 @@ good example of this is the ``PCService``, or even the aforementioned ``DeviceSe
 fulfills the purpose of handling power management, like shutting down or rebooting the system. This service must be
 queryable at any point in time, whenever the user wishes to shut down or reboot their PC. Similarly (but more so
 to the end user), the ``DeviceService`` allows querying any initialized device driver in the system. This is
-particularly useful if you want to, say, get all ``IGraphicsDevice``s in the system, or even get a very specific device
+particularly useful if you want to, say, get all ``IGraphicsDevice`` devices in the system, or even get a very specific device
 like a ``StandardKeyboard``.
 
 Either way, here, we initialize a total of **5 new services**, all of which most likely need no introduction now. But,

Source/Docs/compiler-design.rst

@@ -1,5 +1,5 @@
 ###############
-Compiler Design
+Compiler design
 ###############
 
 The MOSA Compiler framework is designed around two pipelines, each with multiple stages, and a type system.

Source/Docs/compiler-optimizations.rst

@@ -1,5 +1,5 @@
 ######################
-Compiler Optimizations
+Compiler optimizations
 ######################
 
 Optimizations

Source/Docs/compiler-transformations.rst

@@ -1,5 +1,5 @@
 ########################
-Compiler Transformations
+Compiler transformations
 ########################
 
 The MOSA compiler uses a database of transformations to represent specific types of optimizations. These transformation

Source/Docs/contents.txt

@@ -13,6 +13,7 @@
    :maxdepth: 1
 
    getting-started
+   usb-flash-drive-installation
    demos
 
 .. toctree::
@@ -26,6 +27,15 @@
    tool-explorer
    tool-debugger
 
+.. toctree::
+   :caption: Utilities
+   :hidden:
+   :maxdepth: 1
+
+   unit-tests
+   create-core-library
+   source-code-generator
+
 .. toctree::
    :caption: Settings
    :hidden:
@@ -59,14 +69,6 @@
 
    runtime-tables
 
-.. toctree::
-   :caption: Advanced
-   :hidden:
-   :maxdepth: 1
-
-   unit-tests
-   usb-flash-drive-installation
-
 .. toctree::
    :caption: Contribute
    :hidden:

Source/Docs/create-core-library.rst

@@ -0,0 +1,56 @@
+###################
+Create core library
+###################
+
+To implement its own core library, MOSA generates a "dummy" one that includes all the public APIs but without the actual implementation code. The **Create core library** utility takes care of doing that work. To clone the official .NET core library repository, it requires ``git``. Here are the available command line arguments for the utility:
+
+.. csv-table::
+   :header: "Short name","Long name","Description"
+   :widths: 100, 100, 50
+
+    -o,\-\-output,Sets the output directory.
+    -c,\-\-copy-files,"If enabled, only copies and patches the source files and stops."
+
+To run the utility, simply execute the following command on any platform:
+
+.. code-block:: bash
+
+	dotnet bin/Mosa.Utility.CreateCoreLib.dll -o Output
+
+The process can take between a few seconds to a few minutes depending on the speed of your internet connection and PC. At the end, you should get a ``System.Runtime.dll`` file at the directory where you executed the utility. At the end, you should get a console output that looks like this:
+
+.. code-block:: text
+
+  Cloning .NET runtime GitHub repository...
+  Cloning into 'runtime'...
+  remote: Enumerating objects: 65953, done.
+  remote: Counting objects: 100% (65953/65953), done.
+  remote: Compressing objects: 100% (42248/42248), done.
+  Receiving objects: 100% (65953/65953), 88.04 MiB | 9.16 MiB/s, done.
+  remote: Total 65953 (delta 25898), reused 34761 (delta 20956), pack-reused 0 (from 0)
+  Resolving deltas: 100% (25898/25898), done.
+  Updating files: 100% (58901/58901), done.
+  Parsing input files...
+  Patching System.DirectoryServices.manual.cs...
+  Patching System.Net.Http.Json.cs...
+  Patching System.Net.Http.WinHttpHandler.cs...
+  Patching System.Configuration.ConfigurationManager.cs...
+  Patching System.Data.Common.cs...
+  Compiling source files...
+  Decompiling assembly...
+  Removing project file...
+  Removing Properties folder...
+  Patching System.Collections.Generic/PriorityQueue.cs...
+  Patching System.Collections.Generic/PriorityQueue.cs...
+  Patching System/Nullable.cs...
+  Patching System/ReadOnlySpan.cs...
+  Patching System.Runtime.InteropServices/Marshal.cs...
+  Patching System.Runtime.InteropServices/MemoryMarshal.cs...
+  Patching System.Runtime.CompilerServices/Unsafe.cs...
+  Patching System.Numerics/Vector.cs...
+  Patching System.Runtime.Intrinsics/Vector64.cs...
+  Patching System.Runtime.Intrinsics/Vector128.cs...
+  Patching System.Runtime.Intrinsics/Vector256.cs...
+  Patching System.Runtime.Intrinsics/Vector512.cs...
+  Patching System.Threading/Volatile.cs...
+  Patching System.Threading/Interlocked.cs...

Source/Docs/demos.rst

@@ -12,7 +12,7 @@ CoolWorld
 
 It's MOSA's flagship demo. It can boot into either console mode (containing a shell with a few basic commands) or
 graphical mode (which makes use of the GPU and some other features offered by MOSA). You can boot into console mode by
-inserting the `-bootoptions coolworldui=consolemode` command line option when starting the MOSA launcher.
+inserting the ``-bootoptions coolworldui=consolemode`` command line option when starting the MOSA launcher.
 
 Console mode:
 

Source/Docs/faq.rst

@@ -45,4 +45,4 @@ Are Cosmos and MOSA working together?
 Recently, there have been talks to integrate the MOSA compiler into Cosmos, thus potentially being able to implement
 more features in the MOSA compiler while also providing more stability and performance for Cosmos. While nothing has
 come out of this yet, you can express your opinion on this in our Discord in #cosmos-integration and in the Cosmos
-Discord in #mosa-cosmos-crossdev.
+Discord in #dev-mosa-cosmos.

Source/Docs/get-involved.rst

@@ -1,5 +1,5 @@
 ############
-Get Involved
+Get involved
 ############
 
 We need your help!
@@ -35,5 +35,5 @@ contributions if you:
 Please be careful with any contribution you make regarding to patents, other open source licenses and any potential
 restrictions. We can only accept contributions compatible with the
 `New BSD License <http://en.wikipedia.org/wiki/BSD_licenses>`__. MIT license is a compatible license, while GNU licenses
-are incomparable. Read more about our :doc:`license` policy.
+are incomparable. Read more about our :doc:`license<license>` policy.
 

Source/Docs/getting-started.rst

@@ -1,5 +1,5 @@
 ***************
-Getting Started
+Getting started
 ***************
 
 Prerequisites
@@ -20,12 +20,12 @@ On Linux, the following prerequisites are necessary:
 * `Git <https://git-scm.com/>`__ (only if you want to clone and build manually)
 * `QEMU <https://www.qemu.org/>`__
 
-If you're using Ubuntu 22.04, you can use the following commands to quickly set everything up:
+If you're using Ubuntu 24.04, you can use the following commands to quickly set everything up:
 
 .. code-block:: bash
 
 	# Register Microsoft package repository
-	wget -q https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
+	wget -q https://packages.microsoft.com/config/ubuntu/24.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
 	sudo dpkg -i packages-microsoft-prod.deb
 
 	# Install the .NET Core SDK