wordsmithing

prebid-server/developers/add-a-module-java.md

@@ -96,9 +96,9 @@ The structure of your module source code inside the modules directory must have
 ## Module Configuration
 There are several places to configure a module:
 
-- **Host/Bean config** is stored in one of the YAML files, primarily used for enabling the module altogether (`hooks.<MODULE_CODE>.enabled`). It should only contain static config which applies to the entire prebid server, potentially independently from account configuration, or no config at all, apart from enabled flag.
-- **Default account config** is stored in one of the YAML files, only used when there is an actual account present. It is used to define defaults for all accounts globally.
-- **Account/Runtime config** is stored in the database, or YAML file, or anywhere else depending on the backend used. It is used to define individual account configuration.
+- **Host/Bean config** is stored in one of the YAML files (generally application.yaml), primarily used for enabling the module at the server level with `hooks.<MODULE_CODE>.enabled`. It should only contain static config which applies to initial startup independent from any account. Most modules have no host-level config at all, apart from enabled flag.
+- **Default account config** is stored in a YAML file, but only used when account config is available (i.e. it's not seen at the entrypoint stage). It is used to define defaults for all accounts.
+- **Account/Runtime config** is stored in the database, YAML file, or whatever other account backend used. It is used to define individual account configuration.
 
 Important Notes: