From 82c2f5a065a0ff6411c72548e6b82c26ca2fa17b Mon Sep 17 00:00:00 2001 From: Lance Edgar Date: Tue, 6 Sep 2022 13:38:17 -0500 Subject: [PATCH] Add warning about db settings cache cannot recommend this yet; not sure when that will change --- docs/base/config/db.rst | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/base/config/db.rst b/docs/base/config/db.rst index fd1110c..a95cdda 100644 --- a/docs/base/config/db.rst +++ b/docs/base/config/db.rst @@ -89,6 +89,12 @@ specify a flag when reading the value, for example: DB Settings Cache ----------------- +.. warning:: + + Unfortunately at this time the caching mechanisms described below + are **not reliable**. Docs remain in place for now, but it is very + much *not recommended* to enable caching. + One downside of reading config values from the DB settings table, is the number of queries involved, as each call to ``config.get()`` would normally involve a separate SQL query. (Not only that, but unless a