ID: 21970
Updated by: [EMAIL PROTECTED]
Reported By: philip at cornado dot com
Status: Verified
Bug Type: Documentation problem
Operating System: all
PHP Version: N/A
Assigned To: aidan
New Comment:
Somewhere down the line this bug report got renamed so be sure it's not
closed until include_path is properly (extensively) documented.
Not everything belongs in a tutorial...I agree with Goba on all points.
Previous Comments:
------------------------------------------------------------------------
[2005-01-24 16:44:24] [EMAIL PROTECTED]
I agree with both Anatoly & Goba, here.
- Getting started needs to be easily found by new developers.
- And ~"Techniques" is a good name for the section we envisioned as
"Tutorials" they're programming (usually php-specific or web-specific)
techniques.
- Perhaps a note should be dropped into the intro to
"features/techniques" section that links to Getting Started.
S
------------------------------------------------------------------------
[2005-01-23 15:09:06] [EMAIL PROTECTED]
I think 'getting started' should be left alone, it is quite good for a
beginner to start. If you look a bit closely at 'features' though, it
is the exact place where tutorials are located already. We agreed on it
before AFAIR that extension specific tutorials should go into their
reference part, while broader scope tutorials or core tutorials should
go into 'features'. Now we can rename it to 'PHP Programming
Techniques' or something more flashy, but I think it is the right place
to push tutorials into (except the getting started tutorial).
Derek: 'reference' should be very far from being confused with
'tutorial' IMHO!
------------------------------------------------------------------------
[2005-01-23 14:50:02] [EMAIL PROTECTED]
No, getting started is for beginners and they should be able to get to
this page as fast as possible by just clicking "next" link or by
looking at Table of Contents. Being good attractor for newbies "Getting
Started" should be located at the top of ToC and visible by default.
"Language Reference" is too dull to reflect how clear and easy PHP is.
------------------------------------------------------------------------
[2005-01-23 08:23:39] [EMAIL PROTECTED]
I believe we should rename Getting Started to Tutorials (or something
similar and relevant), and move it below Language Reference. The
introduction section of Getting Started should be moved to the
beginning of the Language Reference section. This seems to fit best.
Right now 'Getting Started' is an oddball.
------------------------------------------------------------------------
[2005-01-23 08:19:10] [EMAIL PROTECTED]
I disagree. I think a lot of that content was added because there was
no other good place for it.
It would be nice to get some feedback from Goba!
------------------------------------------------------------------------
The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
http://bugs.php.net/21970
--
Edit this bug report at http://bugs.php.net/?id=21970&edit=1
