Deprecated - Documentation

I took a quick look at the documentation mailing list archive and saw this:

'We keep telling people that contributing to documentation
starts by adding and/or refactoring even a single page (all users have
this permission)....we don't get a lot of takers, so the documentation
doesn't get updated.'

Has anyone come up with any documentation *with* examples on how to use dript. This looks like it has a great deal of promise, however I'm having a bit of trouble getting off the ground with it and need to see some documentation with examples.

I did visit Roland's dript site but didn't dint what I was looking for. Any help getting started would be greatly appreciated.

Thanks!

Admittedly I am new to Drupal and CMS in general. My ignorance gives me a point of view that gets lost as a person becomes closer to the subject. What I am seeing with the Drupal documentation is it seems to have no logical starting point, a place where a person can start from scratch and work themselves up. I have been looking at tutorials and I find that there are unstated premises that assume I know something in order to interpret the text. I am sure I will eventually figure the stuff out (if I stick with it) but right now the tutorials don't make sense.

For those of you who have used Fantastico to install Drupal, there are a couple of things that you should be aware of when it comes time to upgrade:

The biggest thing to know is that Fantastico's upgrade script will delete any modifications, themes or modules you have added.

The recommended procedure* for upgrading is as follows:

• Ideally you should install and upgrade Drupal yourself without using Fantastico.
• If you modified the Drupal code or added any modules, you should upgrade manually. Do not use Fantastico to upgrade.
• If you have not modified any of Drupal, have not added any modules, and have not added any themes, Fantastico may be a viable method of upgrading.
• If the only thing you have added or modified is the themes, you can still use Fantastico to upgrade, but you will have to restore your themes manually via FTP (or other methods).

If you have only modified or added themes, one way of upgrading would be to:

1. Backup Drupal (I know Fantastico backs it up for you, but to be safe, I would back it up to your hard drive anyway... might be useful if the server ever crashes).
2. Take note of which themes you added or modified.
3. Switch to a default theme to be safe (so you can login if there are problems with your added/modified theme)
4. Use Fantastico to upgrade Drupal.

I've been looking over Drupal's documentation from the perspective of a new person and I noticed that its organization is very unconventional, which makes it difficult to find things. Here are my initial observations:

Hi there,

How would one go about getting an offline access to the Drupal Handbook? I will be traveling in the coming week and may not have Net access but will continue to develop my site. It would be great to have access to the Handbook, either a mysql dump or something which I can locally install on my laptop and use.

Thanks in advance.
/c4