[documentation] [Documentation bug] Back up you site (command line) contains errors

[Senpai]

Issue status update for 
http://drupal.org/node/103867
Post a follow up: 
http://drupal.org/project/comments/add/103867

 Project:      Documentation
 Version:      <none>
 Component:    Installation
 Category:     bug reports
 Priority:     normal
 Assigned to:  Anonymous
 Reported by:  kbals
 Updated by:   Senpai
 Status:       active

"PNM said: I'm trying to work on #3, but it seems difficult to structure
this page without headings, as suggested by the Handbook style guide.

"
I'm having much the same trouble with editing certain pages which would
normally require some sort of a document structure. Headings are a
normal part of written, printed documentation, and to purposefully avoid
them is catastrophic to the casual reader.


Out of sheer curiosity, and without pushing any agenda, what is the
purpose of avoiding Headings on Handbook pages?
--
Senpai




Senpai



Previous comments:
------------------------------------------------------------------------

Sun, 17 Dec 2006 22:00:19 +0000 : kbals

URL: http://drupal.org/upgrade/backing-your-site-command-line
1) The instructions show to backup are not clear (second line should be
split):
This:
-------
cd drupal_site/
wget
http://cvs.drupal.org/viewcvs/*checkout*/drupal/contributions/sandbox/dr...
chmod +x drupalsqldump.sh
-------
should be modified into:
-------
cd drupal_site/
wget
http://cvs.drupal.org/viewcvs/*checkout*/drupal/contributions/sandbox/dr...
chmod +x drupalsqldump.sh
-------


2) The following text contains escaped greater than signs '&gt;'
instead of '>'. In addition, the previous instructions indication the
the current directory is already drupal_site, so this part of the path
should be removed.
This:
------------
    * If you are running a version of Drupal that is 4.6 or newer, then
enter the following:


      ./drupalsqldump.sh drupal_site/sites/default/settings.php &gt;
backup/backup.sql
    * If you are running a version of Drupal 4.5 or older, run the
following:


      ./drupalsqldump.sh drupal_site/includes/conf.php &gt;
backup/backup.sql
------------
should be modified into:
------------
    * If you are running a version of Drupal that is 4.6 or newer, then
enter the following:


      ./drupalsqldump.sh sites/default/settings.php > backup/backup.sql
    * If you are running a version of Drupal 4.5 or older, run the
following:


      ./drupalsqldump.sh includes/conf.php > backup/backup.sql
------------


3) The instructions should also explain how to recover once something
went wrong:
-------
cd drupal_site/
wget
http://cvs.drupal.org/viewcvs/*checkout*/drupal/contributions/sandbox/dr...
chmod +x drupalsql.sh
./drupalsql.sh sites/default/settings.php < backup/backup.sql
-------




------------------------------------------------------------------------

Sat, 20 Jan 2007 06:59:47 +0000 : pnm

#1 is done, but #2 and #3 remain.




------------------------------------------------------------------------

Fri, 02 Feb 2007 04:56:06 +0000 : pnm

#2 done.


I'm trying to work on #3, but it seems difficult to structure this page
without headings, as suggested by the Handbook style guide [1]. There
are * in there around what are essentially the headings. Should I just
insert another of those?
[1] http://drupal.org/about/authoring