diff --git a/docs/extensions/index.md b/docs/extensions/index.md
index f59a5487382bdecf553ee2b5a89cfdd877bb6d4e..3959d4f010060dec286a57b6c63cef7a4cffdc9a 100644
--- a/docs/extensions/index.md
+++ b/docs/extensions/index.md
@@ -13,7 +13,10 @@ This section covers how to write extensions.
 
 ## Extension Names
 
-All extension names follow the same convention as Java package names – they look like reversed domain names. (e.g.  `com.example.myextension`). For module-extensions, the last word in the module name will be the module's *short-name*. The short-name *must* be unique. It is possible to pick a different short-name, but that requires extra work.
+Pick a unique single word for your extension's name. Note that this name is used throughout the extension's code, e.g. function names, so it should only include characters that can be safely used in that way.
+
+``` info
+    Historically, extension names used to follow the same convention as Java package names – they look like reversed domain names. (e.g.  `com.example.myextension`), but this is no longer the recommendation.
 
 ## Pre-Requisites