feat: Document inheritance as an experimental feature. (#164)

* document experimental features and inheritance

* refactor: move page to reference tab

* refactor: improves experimental feats

Moves warning underneath heading.
changes wording of warning

exchanges feature-options from list to table with description

improves wording in inheritance-intro and info box

* refactor: changes default for userCanEditFullName to false

docs/06-concepts/11-authentication/01-setup.md

@@ -97,7 +97,7 @@ void run(List<String> args) async {
 | **emailSignInFailureResetTime** | The reset period for email sign in attempts. Defaults to 5 minutes.| 5min |
 | **userCanEditUserImage** | True if users can update their profile images.| true |
 | **userCanEditUserName** | True if users can edit their user names. | true |
-| **userCanEditFullName** | True if users can view their user name. | true | 
+| **userCanEditFullName** | True if users can view their user name. | false | 
 | **userCanSeeUserName** | True if users can view their user name. | true |
 | **userCanSeeFullName** | True if users can view their full name. | true |
 | **enableUserImages** | True if user images are enabled. | true | 

docs/06-concepts/18-experimental.md

@@ -0,0 +1,50 @@
+# Experimental features
+
+:::warning
+Experimental features should not be used in production environments, as their stability is uncertain and they may receive breaking changes in upcoming releases.
+:::
+
+"Experimental Features" are cutting-edge additions to Serverpod that are currently under development or testing. These features allow developers to explore new functionalities and provide feedback, helping shape the future of Serverpod. However, they may not be fully stable or complete and are subject to change.
+
+By default, experimental features are disabled. To opt into using them, include the `--experimental-features` flag when running the serverpod command:
+
+```bash
+$ serverpod generate --experimental-features=all
+```
+
+The current options you can pass are:
+
+|**Feature**|Description|
+|:-----|:---|
+| **all** | Enables all available experimental features. |
+| **inheritance** | Allows using the `extends` keyword in your model files to create class hierarchies.|
+
+## Inheritance
+
+Inheritance allows you to define class hierarchies in your model files by sharing fields between parent and child classes, simplifying class structures and promoting consistency by avoiding duplicate field definitions.
+
+```yaml
+class: ParentClass
+fields:
+    name: String
+```
+
+```yaml
+class: ChildClass
+extends: ParentClass
+fields:
+    int: age
+```
+
+This will generate a class with both `name` and `age` field.
+
+```dart
+class ChildClass extends ParentClass {
+    String name
+    int age
+}
+```
+
+:::info
+The `extends` keyword does not work for models with a `table` field.
+:::