epic: Improve the database docs

[Swiftaxe]

Summary of the issue

Investigate and improve the database docs to:

• Clarify
• Simplify
• Add missing steps and code examples
• Address coverage gaps and common questions