backdrop-ops / backdropcms.org

Issue tracker for the BackdropCMS.org website
https://backdropcms.org
25 stars 21 forks source link

Reword upgrade instructions @ https://backdropcms.org/upgrade #357

Open SamStamport opened 7 years ago

SamStamport commented 7 years ago

Steps 6 & 7 seem ambiguous. Possible re-wording:

  1. Rename the root directory of your current codebase/file structure "old" or similar, and move it outside your Backdrop root directory.

  2. Put the newly downloaded codebase/file structure from the latest release of Backdrop CMS inside your root directory."

I would also add a step 7.5. Copy the settings.php file from the "old" directory to the root directory replacing the one that was downloaded. (This prevents "$database =" settings from being clobbered.) If there is the possibility of settings.php changing from release to release this should probably read "Copy & replace the line in settings.php starting with "$database =" with the original line in the "old" directory.

I would also remove the quotes around "Administrator" in step 4.

Another possibility: reword step 3 language; something like download the latest backdrop release; We will only need the core directory from the download for an upgrade

serundeputy commented 7 years ago
  1. Rename the root directory of your current codebase/file structure "old" or similar, and move it outside your Backdrop root directory.

That won't work you are only supposed to rename the BACKDROP_ROOT/core directory to BACKDROP_ROOT/old-core-1.6.1 not the whole backdrop codebase.

SamStamport commented 7 years ago

How about -

  1. Rename the root directory of your current core directory to "old" or similar, and move it outside your Backdrop root directory.

  2. Put the newly downloaded core directory from the latest release of Backdrop CMS inside your root directory.