Re: Smarty manual - chapter name change
Pedro <[email protected]> Mon, 09 Oct 2006 23:23:49 +0100
| Newsgroups | gmane.comp.php.smarty.devel |
|---|---|
| Message-ID | <[email protected]> |
Whaw this email has ended up all one one line.. how you done that ?! boots wrote: > 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 havent changes any of that working. Its the same as before 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? << ## Not sure as we need people to read the functions and attributes first .. maybe... > > My 2c. > > Pedro <[email protected]> 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. -- Smarty Development Mailing List (http://smarty.php.net/) To unsubscribe, visit: http://www.php.net/unsub.php