#21970 [Ver]: Creating a new Tutorial section

ID: 21970 Updated by: sean@php.net 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: 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 Previous Comments: ------------------------------------------------------------------------ [2005-01-23 15:09:06] goba@php.net 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] techtonik@php.net 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] derek@php.net 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] aidan@php.net 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] derek@php.net 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. ------------------------------------------------------------------------ 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