Ticket #8590: 8590.comment-upgrade-doc.diff

django/django/docs/ref/contrib/comments/upgrade.txt

@@ -29 +29 @@
 Upgrading data
 --------------
 
-The data models have changed, as have the table names. To transfer your data into the new system, you'll need to directly run the following SQL:
+The data models have changed, as have the table names. First, make sure that you
+have installed the new system as explained in the
+:ref:`quick start guide <ref-contrib-comments-index-quick-start-guide>` so that
+the new tables are properly created. Then, to transfer your data into the new
+system, you'll need to directly run the following SQL:
 
 .. code-block:: sql
 
@@ -61 +65 @@
     );
     
     COMMIT;
+
+Finally, if you're directly updating the code via SVN, make sure to delete all
+stale *.pyc files remaining from the old system as they may cause some clashes.
+ No newline at end of file