Write first pass of Python features

Author: Maxime Mangel

docs/docs/getting-started/python.md

@@ -3,6 +3,9 @@ title: Python
 layout: standard
 ---
 
+:::warning
+Python target is in beta meaning that breaking changes can happen between minor versions.
+:::
 
 This section is specific to Python targetting, it will guide you through the process of setting up your project and using Fable with Python.
 

docs/docs/javascript/features.md

@@ -333,7 +333,7 @@ Deconstruct a tuple of arguments and generate a JavaScript expression.
 > Expressions are values or execute to values, they can be assigned or used as operands
 
 ```fs
-open Fable.Core
+open Fable.Core.JsInterop
 
 let two : int =
     emitJsExpr (1, 1) "$0 + $1"
@@ -361,7 +361,7 @@ Deconstruct a tuple of arguments and generate a JavaScript statement.
 > Statements are the whole structure, while expressions are the building blocks. For example, a line or a block of code is a statement.
 
 ```fs
-open Fable.Core
+open Fable.Core.JsInterop
 
 let add (a : int) (b : int) = 
     emitJsStatement (a, b) "return $0 + $1;"
@@ -499,7 +499,7 @@ let test(arg: U3<string, int, float[]>) =
 
 ### Erased types
 
-Decoring a type with `[<Erased>]` allows you to instruct Fable to not generate any code for that type. This is useful when you want to use a type from a JS library that you don't want to generate bindings for.
+Decoring a type with `[<Erase>]` allows you to instruct Fable to not generate any code for that type. This is useful when you want to use a type from a JS library that you don't want to generate bindings for.
 
 ```fs
 open Fable.Core
@@ -537,7 +537,7 @@ export function User_$ctor() {
 export const x = Avatar("123");
 ```
 
-As you can see, there are some reflection information generated for the type `User`. However, if you decorate the type with `[<Erased>]`:
+As you can see, there are some reflection information generated for the type `User`. However, if you decorate the type with `[<Erase>]`:
 
 ```fs
 open Fable.Core
@@ -961,7 +961,7 @@ search("foo", {
 
 Because JavaScript doesn't support overloading or multiple modules in a single file, Fable needs to mangle the name of some members, functions to avoid clashes.
 
-However, Fable will changes the names of:
+However, Fable will never changes the names of:
 
 - Record fields
 - Interface and abstract members
@@ -1129,7 +1129,7 @@ let execute (f: int->int->int) x y =
 ```
 
 ```js
-import { execute } from "./TestFunctions.fs"
+import { execute } from "./TestFunctions.fs.js"
 
 export function execute(f, x, y) {
     return f(x, y);

docs/docs/menu.json

@@ -41,7 +41,6 @@
         "label": "JavaScript",
         "items": [
             "docs/javascript/build-and-run",
-            "docs/javascript/testing",
             "docs/javascript/features",
             "docs/javascript/compatibility"
         ]
@@ -51,11 +50,20 @@
         "label": "TypeScript",
         "items": [
             "docs/typescript/build-and-run",
-            "docs/typescript/testing",
             "docs/typescript/features",
             "docs/typescript/compatibility"
         ]
     },
+
+    {
+        "type": "section",
+        "label": "Python",
+        "items": [
+            "docs/python/build-and-run",
+            "docs/python/features",
+            "docs/python/compatibility"
+        ]
+    },
     {
         "type": "section",
         "label": "Miscellaneous",

docs/docs/python/build-and-run.md

@@ -0,0 +1,12 @@
+---
+title: Build and Run
+layout: standard
+---
+
+When targetting python, you can use the output of Fable directly by running it with the python interpreter.
+
+For example:
+
+```bash
+python3 Program.py
+```

docs/docs/python/compatibility.md

@@ -0,0 +1,12 @@
+---
+title: .NET and F# compatibility
+layout: standard
+---
+
+:::warning
+Python target is in beta meaning that breaking changes can happen between minor versions.
+:::
+
+:::warning
+This section is still under construction.
+:::