Add getting-started for python

Author: Maxime Mangel

docs/docs/getting-started/python.md

@@ -1,8 +1,73 @@
 ---
-title: TypeScript
+title: Python
 layout: standard
 ---
 
+
+This section is specific to Python targetting, it will guide you through the process of setting up your project and using Fable with Python.
+
+:::info
+Please make sure you followed the [Fable setup guide](/docs/2-steps/your-first-fable-project) before continuing.
+:::
+
+
+<ul class="textual-steps">
+
+<li>
+
+Run your code.
+
+```bash
+python3 program.py
+```
+
+</li>
+
+<li>
+
+When targeting Python, you will want to install the `Fable.Python` package. It provides a set of bindings to the Python standard library, and so others common libraries.
+
+```bash
+dotnet add package Fable.Python
+```
+
+</li>
+
+
+<li>
+
+Change the content of `Program.fs` to the following:
+
+```fs
+
+open Fable.Python.Builtins
+
+let file = builtins.``open``("test.txt", OpenTextMode.Write)
+file.write("Hello World!") |> ignore
+```
+
 :::info
-This section is under construction.
-:::
+Python bindings are early stage, so some APIs are not yet available.
+
+You can report missing APIs or send PR on the [Fable.Python repository](https://github.com/fable-compiler/Fable.Python)
+:::
+
+</li>
+
+<li>
+
+Run Fable in watch mode
+
+```bash
+dotnet fable watch
+```
+
+If you run your node script again, you should see a new file `test.txt` with the content `Hello World`.
+
+Try changing the content of `Hello World` to something else and re-run your script.
+
+You should see that Fable re-compile your code and the file content changed.
+
+</li>
+
+</ul>

docs/docs/getting-started/typescript.md

@@ -120,13 +120,12 @@ Run Fable and TypeScript in watch mode.
 
 The follwing command start Fable in watch mode, and after the first Fable compilation, it will start TypeScript in watch mode.
 
-In the [TypeSript]() section, we will learn how to use [Fun.Build]()
-to organize and simplify our build process.
-
 ```bash
 dotnet fable watch --lang typescript --run npx tsc Program.fs.ts --target es2022 --watch --preserveWatchOutput
 ```
 
+> You can use your favorite build system instead to launch the different commands in parallel.
+
 If you run your node script again, you should see a new file `test.txt` with the content `Hello World`.
 
 Try changing the content of `Hello World` to something else and re-run your script.

docs/docs/getting-started/your-first-fable-project.md

@@ -81,8 +81,8 @@ To go further look into the respective target documentation to have an example o
 
 - [JavaScript](/docs/getting-started/javascript.html)
 - [TypeScript](/docs/getting-started/typescript.html)
-<!-- - [Dart](/docs/getting-started/dart.html)
 - [Python](/docs/getting-started/python.html)
+<!-- - [Dart](/docs/getting-started/dart.html)
 - [Rust](/docs/getting-started/rust.html)
 - [PHP](/docs/getting-started/php.html) -->
 

docs/docs/menu.json

@@ -15,7 +15,8 @@
             "docs/getting-started/setup",
             "docs/getting-started/your-first-fable-project",
             "docs/getting-started/javascript",
-            "docs/getting-started/typescript"
+            "docs/getting-started/typescript",
+            "docs/getting-started/python"
         ]
     },
     {