|
|
Posted by Rincewind on 10/10/49 11:25
On Tue, 30 Aug 2005 23:59:10 -0700, Michael Vilain wrote:
> In article <1125459010.232176.201160@z14g2000cwz.googlegroups.com>,
> "Lateralus" <phpdeity@gmail.com> wrote:
>
>> One thing I've always noted about the manual is that in itself it
>> cannot encompass "the right way" of doing things. It can give you the
>> functions and API documentation you'll need to perform whatever task
>> you may want to do, but it cannot tell you which API's to use and which
>> to not. These are the types of things Tutorial websites try to do, and
>> most often fail at. We have to document X and Y no matter if we know X
>> may be faster than Y (and as such X should be used in place of Y
>> whenever possible). Here and there it is our duty to point things of
>> this manner out, but we have to be largely impartial. This, in my
>> opinion, is the only failing of the PHP manual in and of itself.
>>
>
> Well, if you're decide to write that book, rethink the "right way"
> approach. There is no such thing. There's options and approaches to
> solving problems. If you think there's only one "right way" to solve a
> problem, you may also think there's only one god.
>
> Yes, this is a religious issue. Don't go there.
I agree there is never a right way, however there is an optimum way, this
is something that is picked up in the Notes version of the help file where
the posters have pointed out what they consider the optimum way of
achieving things.
>> I've decided to write a supplemental book which should be read
>> alongside the Manual. It will be a companion, correcting -- hopefully
>> -- a few of the things I've always felt were missing or inadequately
>> represented in the Manual. Again, this will be entirelly supplemental.
>> It will not re-teach what has been adequately described in the Manual,
>> and as such shouldn't immediately fall prey to the failings of other
>> books; largely that they are immediately deprecated.
>>
Sounds good.
>> And, sorry PHPGB. This book will not contain any "example websites" for
>> you to play with. There is and can be no "catch all website tutorial,"
>> and most certainly not a "mini" one.
>>
>> What I'm mainly going to try and capture and correct is the Manual's
>> lack of "suggestion." I will provide the opinions which we couldn't add
>> to the manual about X and Y, and try to encompass as many PHP idioms as
>> possible. Hopefully, once I am done, the Manual and this book as
>> companions will be able to better teach "how to program PHP."
>>
This is where the notes version of the manual has been of great help to me
however it isn't exhaustive, so a companion would be nice.
>> This book will be completely free and available online in several
>> formats. At this point I don't know if I will release it publicly
>> before it is completed or not. I'm leaning towards not, but who knows.
>> I am guessing that it will take me roughly three months or so to
>> complete this work... but I could be entirelly wrong. We'll see.
I look forward to seeing it
Navigation:
[Reply to this message]
|