[drupal-docs] Troubleshooting faq section (needs to be condensed)

[Richard Eriksson]

On Mon, 07 Mar 2005 17:59:23 +0900, Anisa <mystavash at animecards.org> wrote:
>  Yay.  Thanks.  :)  Can you also make this file not the first one under the
> installation guide?  Surely Installation Process/System Requirements should
> go before it.  :)

For reference: http://drupal.org/node/258

Yeah.  I made the system requirements the first link, and made some
formatting changes to that document as well (didn't change the
content).  "Installation process" should ideally be the second link on
that page, but I don't have edit permissions for that one.  Perhaps we
should use http://drupal.org/node/261 instead of that, since
"Installation process" uses the INSTALL.txt for Drupal, and is hard to
read when it's in monospace format as it is.  (Plus
http://drupal.org/node/261 is a book page which site maintainers can
edit, even if it means copying & pasting in INSTALL.txt text.)  I
edited the "General Instructions" fairly significantly to remove notes
about installing and compling Apache and PHP as well as rewrote a
bunch of text.

>  I am not sure how many non-windows users wouldn't be able to figure out how
> to install additional modules themselves, but certainly, it's windows
> centric.  If you need to add specific info for other OSs, then you want to
> seperate it out, windows users this, linux users that.

Ideally instructions on installing anything that's web-based is not
specific to platforms, but just that since most web servers are
Unix-based, that's kind of how things have gone.  I'll look around and
see how much can be made not-platform-specific.

>  'If it's already on your host, move the folder to your Drupal modules/
> folder, replacing 'modulename' with the folder that uncompressing created on
> your host and 'path/to/drupal/' with the actual path to where you installed
> Drupal.'
>  
>  perhaps this is a reference to the previous section where the user has
> directly extracted to the host...  I definitely think this should be
> seperated out.  The newbie windows user uploading via FTP needs to know that
> this doesn't apply to him.  

Right.  There needs to be info on uploading modules via FTP,
absolutely.  Actually, after the edits I just made to
http://drupal.org/node/17473 there should probably be some
instructions on how to install a module from the Unix command line
entirely!  :)

-- 
Richard Eriksson
Bryght Community Support
http://support.bryght.com/