This is an automated email from the ASF dual-hosted git repository.
maximebeauchemin pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/incubator-superset.git
The following commit(s) were added to refs/heads/master by this push:
new 7c02587 [docs] improve upgrading instructions (#6766)
7c02587 is described below
commit 7c02587924a1c05d8591aa54c316c9c59b18214b
Author: Maxime Beauchemin <[email protected]>
AuthorDate: Mon Jan 28 22:14:02 2019 -0800
[docs] improve upgrading instructions (#6766)
---
docs/installation.rst | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/docs/installation.rst b/docs/installation.rst
index f1a6d76..ecce52f 100644
--- a/docs/installation.rst
+++ b/docs/installation.rst
@@ -616,6 +616,18 @@ Upgrading should be as straightforward as running::
superset db upgrade
superset init
+We recommend to follow standard best practices when upgrading Superset, such
+as taking a database backup prior to the upgrade, upgrading a staging
+environment prior to upgrading production, and upgrading production while less
+users are active on the platform.
+
+.. note ::
+ Some upgrades may contain backward-incompatible changes, or require
+ scheduling downtime, when that is the case, contributors attach notes in
+ ``UPDATING.md`` in the repository. It's recommended to review this
+ file prior to running an upgrade.
+
+
Celery Tasks
------------
On large analytic databases, it's common to run background jobs, reports
