A few rough ideas:
- Ensure class-level doc block for the service class (ExternalStoreAccess) and main interface (ExternalStoreMedium) mention this aspect.
- Ensure these classes and their core implementations are in the ExtenalStorage doc group.
- Ensure a Markdown file exists for the ExtenalStorage component, linked to and from its doc group, in which a bit more historic context and rationale is written about its strategy and design choices. (see JobQueue and FileBackend for examples).