|
|
Posted by Timothy Murphy on 11/15/38 11:25
Rincewind wrote:
>> My main criticism - still not very strong -
>> was that it would have been better to have included clear instuctions
>> on how to run the sample programs.
>
> From the first page of the manuals tutorial
> <Quote>
> What do I need?
> In this tutorial we assume that your server has activated support for PHP
> and that all files ending in .php are handled by PHP. On most servers,
> this is the default extension for PHP files, but ask your server
> administrator to be sure. If your server supports PHP, then you do not
> need to do anything.
<?Quote>
> >
> fairly clear to me!
1. How many people have write access to a directory on a web-server?
2. For those who do not, would it not be helpful
to mention direct use of php?
I would have said something like:
Call this file "hello.php" (without the quotes) and give the command
php hello.php
(Perhaps your idea of a newbie and mine are rather different?)
3. I would also have stated as a clear option
that one could test the programs by running apache
either on a machine on a home LAN, or on a single machine.
Since there are later (inappropriate, in my opinion) instructions
on how to install apache,
I assume this is intended as an alternative method.
Why not say: You can run the following programs
in one of three ways: 1 ..., 2 ..., 3 ?
Don't forget, I gave the tutorial 7/10 -
pretty good, but could be better.
I think one requirement in a good tutorial
is that the actual commands given should be "photo-copied".
A verbal description - such as the above
"Just create your .php files, put them in your web
directory and the server will automatically parse them for you"
will not be understood by many readers.
--
Timothy Murphy
e-mail (<80k only): tim /at/ birdsnest.maths.tcd.ie
tel: +353-86-2336090, +353-1-2842366
s-mail: School of Mathematics, Trinity College, Dublin 2, Ireland
Navigation:
[Reply to this message]
|