Clarify update.php doc and mention Database\PostUpdate

diff --git a/src/Database/PostUpdate.php b/src/Database/PostUpdate.php
index 94d00853abc650b086dd67297c4fbe408978123c..7fd28419ea60106eeef11689bb7cb57968a55ed5 100644 (file)
--- a/src/Database/PostUpdate.php
+++ b/src/Database/PostUpdate.php
@@ -10,11 +10,14 @@ use Friendica\DI;
 use Friendica\Model\Contact;
 use Friendica\Model\Item;
 use Friendica\Model\ItemURI;
-use Friendica\Model\UserItem;
 use Friendica\Model\PermissionSet;
+use Friendica\Model\UserItem;
 
 /**
- * Post update functions
+ * These database-intensive post update routines are meant to be executed in the background by the cronjob.
+ *
+ * If there is a need for a intensive migration after a database structure change, update this file
+ * by adding a new method at the end with the number of the new DB_UPDATE_VERSION.
  */
 class PostUpdate
 {

diff --git a/update.php b/update.php
index 4d12730fab6e5cbf05b486bdef307e3238864f5d..22ed4ae9e3cfe3027a4f7edb58f1cfeb31375bcb 100644 (file)
--- a/update.php
+++ b/update.php
@@ -15,15 +15,15 @@ use Friendica\Util\DateTimeFormat;
 use Friendica\Worker\Delivery;
 
 /**
+ * update.php - automatic post-databse structure change updates
  *
- * update.php - automatic system update
- *
- * This function is responsible for doing post update changes to the data
- * (not the structure) in the database.
+ * These functions are responsible for doing critical post update changes to the data (not the structure) in the database.
  *
  * Database structure changes are done in static/dbstructure.config.php
  *
- * If there is a need for a post process to a structure change, update this file
+ * For non-critical database migrations, please add a method in the Database\PostUpdate class
+ *
+ * If there is a need for a post update to a structure change, update this file
  * by adding a new function at the end with the number of the new DB_UPDATE_VERSION.
  *
  * The numbered script in this file has to be exactly like the DB_UPDATE_VERSION