diff --git a/Squadrons-and-pilots.md b/Squadrons-and-pilots.md
index 85fe036..33f82ee 100644
--- a/Squadrons-and-pilots.md
+++ b/Squadrons-and-pilots.md
@@ -1 +1,18 @@
-[Work in progress](https://github.com/dcs-liberation/dcs_liberation/issues/276)
\ No newline at end of file
+**This feature is new in DCS Liberation 3.0.**
+
+This feature is a [aork in progress](https://github.com/dcs-liberation/dcs_liberation/issues/276). This documentation will be improve as the feature nears completion.
+
+## Pilot names
+
+Pilot names are generated randomly (user-defined names will be added later). The generated names are localized based on the `locales` field of the faction definition. For example:
+
+```json
+{
+    "name": "France and Germany",
+    "locales": ["fr_FR", "de_DE"],
+}
+```
+
+Names will be localized if the chosen locale has a `faker.providers.person` listed on https://faker.readthedocs.io/en/master/locales.html.
+
+If the faction has no locales defined, names will be generated using `en_US` (the default for the name generator library).
\ No newline at end of file