Pascal Palenda · Pascal Palenda · Philipp Schäfer
--- a/docs/index.md
+++ b/docs/index.md
+
+## Prototyping
+
+VA interfaces make use of prototyping methods. Instead of using a fixed set of input variables,
+these expect a dictionary with any set of parameters. Such methods can be "extended" by internally
+allowing for new parameters making it easier to maintain backwards compatibility of the VA interfaces.
+Also this allows setting a large set of parameters with a single function call. Prototyping methods usually
+have names similar to `va.set_..._parameters()` or `va.get_..._parameters()`.
+Nevertheless, also variable-based methods are provided for the most common use-cases and should preferably be used.
+
+**Example**
+```python
+# Both of the following calls will create a directivity from a file with name "fig-8"
+D = va.create_directivity_from_file("path/to/file.daff"), "fig-8")
+D = va.create_directivity_from_parameters("fig-8", {"filepath": "path/to/file.daff"})
+```