[documentation] URGENT: Please review upgrade tutorial instructions

Kobus Myburgh itbjdm at puknet.puk.ac.za
Thu Dec 1 06:50:26 UTC 2005


Kieran,

First of all: Great work!

* I have the same font inconsistencies issues than the others and all pages with images in them have at least one missing.

* Also, why are so many of the links duplicated? [1] This is a bit strange to me.

* In the yellow block in the basic steps via GUI [2], you have this: "*** If you are upgrading from a version of Drupal that is older than Drupal 4.5 or older, then...". That sentence is incorrect. How about simply: "*** If you are upgrading from a version older than Drupal 4.5, then..."

* This exact same yellow block also needs some spacing to make it more readible. This is also holds for other places with this yellow box [3][5].

* 3. If you are performing any of these upgrade. You do not need to upgrade your database: 4.5.0 to 4.5.# (Believe that should be 4.5.x? Or 4.5.3? [4] This possible problem occurs on several places on this page.

* I suggest that all blockquoted text (code or blockquote, anyways) be made the same as here [6]. It stands out nicely with the bold inside the block.

* Inconsistencies in bold text, as described above here too: [7].

* [7][8][9][10]: These pages have some comments that can be removed, I believe. Also a lot of the pages after that, but I see this will be a lot of pages, so I won't list them all here.

* [8][9]: Are these pages still necessary? Can't they be deleted? A lot of other pages too - are they still relevant? Not a technical guru, so I won't know, but this page [11] might not be relevant in its entirety anymore.

Regards,

Kobus

[1]
Copying your live site to a test site | (Command-Line Version) 
Basic Upgrade Steps | (Command-Line Version) | (No Database update) 
Optional Configuration Steps 
Testing your newly upgraded site 
Upgrade Finished! 
Copy your test site to your live site | (Command-Line Version) 

Continue to Copying Your Live Site to a Test Site
Jump to Basic Upgrade Steps 

Copy your live site to a test site(GUI version)
Basic Upgrade Steps (GUI version)
Optional Configuration Steps
Testing Your Newly Upgraded Site
Upgrade Finished!
Copy your test site to a live site (GUI Version)

[2] http://drupal.org/upgrade/basic-steps-via-GUI 
[3] http://drupal.org/upgrade/basic-steps-via-command-line 
[4] http://drupal.org/upgrade/upgrading-the-database 
[5] http://drupal.org/upgrade/upgrading-without-a-db-upgrade 
[6] http://drupal.org/upgrade/testing-the-new-site 
[7] http://drupal.org/node/30699
[8] http://drupal.org/node/505
[9] http://drupal.org/node/269
[10] http://drupal.org/node/271
[11] http://drupal.org/node/2602





More information about the documentation mailing list