Update documentation for custom modules

1 files changed, 6 insertions, 0 deletions

diff --git a/modules_v4/example-server-configuration.disable/module.php b/modules_v4/example-server-configuration.disable/module.php
index 1e21e33a0e..1442354391 100644
--- a/modules_v4/example-server-configuration.disable/module.php
+++ b/modules_v4/example-server-configuration.disable/module.php
@@ -8,6 +8,12 @@ declare(strict_types=1);
 
 namespace MyCustomNamespace;
 
+// Unlike the other examples, this one has a separate file for the class definition.
+// This is because the constructor has some dependencies, so we must create it
+// with "app(CustomModule::class)" rather than "new CustomModule()".
+// This means we can't use an anonymous class, and our coding standards
+// mean that the class needs to go in its own file.
+// For simple modules, it might be easier to declare the class here.
 require __DIR__ . '/ExampleServerConfigurationModule.php';
 
 return app(ExampleServerConfigurationModule::class);