As I thought, you were merely trolling. Like I said, if you want to be actually constructive or productive open PRs, with actual documentation for what *you* find confusing. Don't try absurdities like a function named format_metadata() is dangerous because format can have multiple meanings.
There is plenty of low hanging fruit when it comes to documentation. For example, open db/cache.py scroll through all the functions marked with @api or @write_api or @read_api find the un documented ones or under documented ones, and improve the documentation.
If you arent willing to do any actual work yourself, then dont expect other people to do it for you.