Dear @jhig thank you for making our documentation better!
The recommended hint has been added to all SQL charms (the name originally came from MongoDB documentation: Charmhub | Deploy MongoDB using Charmhub - The Open Operator Collection we sent the same notification there).
Tnx!