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:
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.
Previous Comments:
------------------------------------------------------------------------
[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!
------------------------------------------------------------------------
[2005-01-22 21:39:05] [EMAIL PROTECTED]
s/info moved from/info copied from/
We should not move anything from other sections that currently have a
"home" just because a new tutorial is being added. Eg, the things in
the security section need to stay there. We can either reiterate the
points mentioned, or link to the chapters containing the information.
------------------------------------------------------------------------
[2005-01-22 13:57:53] aj_gemmell at yahoo dot com
I suggest features.safe-mode should also be added to this (how it
works, what it does [,when you should use it])
--GwaiLo
------------------------------------------------------------------------
[2005-01-22 10:17:23] [EMAIL PROTECTED]
It seems we are happy enough to add the new section, the question is
where?
Chapter I - Getting Started - Could be renamed to either "Tutorials",
and Getting-Started the first tutorial in that section.
So far, the tutorial section could contain:
- include_path
- php5 patterns
- magic_quotes (info moved from security / faq)
- register_globals (info moved from security / faq)
- command line usage
?- black box design (foo.php?page=contact etc).
?- good sql / database practice (also moved from security section)
------------------------------------------------------------------------
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
