chore(docsite): update README to latest dev

Author: Alenar

docs/website/Makefile

@@ -1,4 +1,4 @@
-.PHONY: clean install build serve dev upgrade
+.PHONY: clean install build serve dev lint format upgrade update-current
 
 package-lock.json:
 	npm install
@@ -27,6 +27,12 @@ clean:
 	rm -rf build
 	rm package-lock.json || true
 
+lint:
+	npm run pretty:check
+
+format:
+	npm run pretty:write
+
 upgrade: clean install
 	# Update to the latest version of react and react-dom when it is supported and does not create dependency conflicts
 	npm install \
@@ -49,9 +55,3 @@ update-current:
 	mv versioned_sidebars/version-updated-sidebars.json  versioned_sidebars/version-maintained-sidebars.json
 	# Remove the entry for the temporary version in the versions.json file
 	sed -i '/updated/d' versions.json
-
-lint:
-	npm run pretty:check
-
-format:
-	npm run pretty:write

docs/website/README.md

@@ -1,44 +1,56 @@
 # Website
 
-This website is built using [Docusaurus 2](https://docusaurus.io/), a modern static website generator.
+This website is built using [Docusaurus 3](https://docusaurus.io/), a modern static website generator.
 
 ### Installation
 
-```
+```shell
 $ make install
 ```
 
-### Local Development
+### Build
 
+```shell
+$ make build
 ```
-$ yarn start
+
+This command generates static content into the `build` directory and can be served using any static contents hosting
+service.
+
+### Local Development
+
+```shell
+$ make dev
 ```
 
 This command starts a local development server and opens up a browser window. Most changes are reflected live without
 having to restart the server.
 
-### Build
+Alternatively, if you need to simulate GitHub pages hosting environment, you can run
 
-```
-$ make build
+```shell
+$ make serve-static
 ```
 
-This command generates static content into the `build` directory and can be served using any static contents hosting
-service.
+This will create a production build and run it on a Python server as a static content.
 
-### Deployment
+### Content versioning
 
-Using SSH:
+This website gives access to two versions of the documentation:
 
-```
-$ USE_SSH=true npx docusaurus deploy
-```
+- `current`:
+  - Hosts the documentation of the latest Mithril distribution
+  - Shown by default
+  - Source code can be found in `./root`
+- `next`:
+  - Hosts the documentation of the upcoming Mithril distribution under development
+  - Accessible by selecting `Next` in the version dropdown in the navbar
+  - Source code can be found in `./versioned_docs/version-maintained`
 
-Not using SSH:
+#### Versions rotation
 
-```
-$ GIT_USER=<Your GitHub username> npx docusaurus deploy
-```
+When releasing a new distribution, the `current` documentation content can be rotated by using the `next` version with the command:
 
-If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to
-the `gh-pages` branch.
+```shell
+make update-current
+```