ZF-7254: Create your project - first page of tutorial documentation has me going, huh?

Issue Type: Docs: Improvement Created: 2009-07-13T19:52:17.000+0000 Last Updated: 2009-07-13T21:51:56.000+0000 Status: Resolved Fix version(s): - 1.9.0 (31/Jul/09)

Reporter: Steven Morehouse (s_mack) Assignee: Matthew Weier O'Phinney (matthew) Tags: Related issues: Attachments:


Trying to get started with zend, I downloaded it and began with your tutorial. It didn't take long to find some problems. This is the first.…

Not really a problem necessarily, but it is to someone new and unfamiliar.

Right out of the box, if you test the error handling (by putting in an erroneous url for example) you get a nonsensical error message. Why? Because code like "

message ?>

" is going to output "

->message ?>

" because a default php installation isn't going to know what the heck message ?>" of course results in what the user would expect.

I'm just beginning. Maybe in the (very near) future it will become obvious why <?= is outputted but step 1 tutorial should result in step 1 success. Not "huh"?

Suggestion: either change the code to something that will work immediately, or explain to the user that it will work later (if something is configured later) or how to configure their php to recognize that kind of output (if not).

Cake and Symfony both also suffer from step 1 tutorial failure. None give much confidence. Before you laugh and call this extremely minor... think who the tutorial is for and look at it from their point of view.


Posted by Matthew Weier O'Phinney (matthew) on 2009-07-13T21:51:27.000+0000

We have already made a decision to standardize all documentation and tutorials to use normal, long tags; unfortunately, the output from Zend_Tool and the QuickStart are out-of-date. Both are fixed in SVN currently, and you will see the changes with the next release.

Have you found an issue?

See the Overview section for more details.


© 2006-2018 by Zend, a Rogue Wave Company. Made with by awesome contributors.

This website is built using zend-expressive and it runs on PHP 7.