Re: [SMARTY-DEV] Smarty manual - chapter name change
| From: | boots | Date: | Mon, 09 Oct 2006 21:25:31 +0000 |
| Subject: | Re: [SMARTY-DEV] Smarty manual - chapter name change | ||
| References: | 1 | Groups: | php.smarty.dev |
| Request: | Send a blank email to php-smarty-dev+get-2900@lists.php.net to get a copy of this message | ||
Seems like changing it to "Quotes and backticks" gives less indication of what the chapter
is about than the current name. Also, please be careful not to change the meaning of the current
docs. The updated WIP page you link'd seems to suggest that any type of expression can be put
in backticks -- this is not so. I think even object attribute reference won't work but your
updated docs suggest they will. -- Actually, I didn't check that and am going from memory --
BUT, method reference does not work. IIR, the only things that do work are the things given in the
examples of the existing doc page (again, I didn't test object attributes so I'll concede
that if it is indeed supported).
So, to me the problem isn't the naming of the chapters -- but rather some folks don't care
to read the chapters to begin with. Reorganizing can possibly help those who do skim the manual as
perhaps improving the content / layout. So I applaud that. Maybe "Embedding Vars" can
become a subchapter of the vars chapter to keep those two together and maybe get people to read
them?
My 2c.
Pedro <daffodil@daffodil.uk.com> wrote: The issue of backticks and quotes, etc is often asked,
particularly on irc
http://smarty.php.net/manual/en/language.basic.syntax.php
So can I make a suggestion which is to rename the page from
"Embedding Vars in Double Quotes"
to
"Quotes and backticks"
so the chapter of the book (anyone published a smarty pocket book yet?)
would look like this
Chapter 3. Basic Syntax
Table of Contents
-----------------
* Comments
* Variables
* Functions
* Attributes
* Quotes and backticks
* Math
* Escaping Smarty Parsing
Also add some more examples
The current example I've already split up into two
ie
"syntax examples" and "practical examples".
The later need some $obj->examples etc. Some gotachas code would be nice
to include so the issue can be nailed in the mind.
What is everyones thought ideas, suggestions et all ?
Pete :-)
---------------------------------
Yahoo! Messenger with Voice. Make PC-to-Phone Calls to the US (and 30+ countries) for 2¢/min or
less.