Possible error in documentation?

[ricky11]

Looking at the documentation from http://doc.prestashop.com/display/PS16/Performance+Parameters

 

Throughout this forum, for speed a lot of users and [spam-filter]'s say to turn on "Never recompile template files" when site is live and no code editing is being done, but the documentation says the complete opposite.  See below.

 

 

• Template cache. For better front-end performance, PrestaShop caches your HTML pages.
  • Never recompile template files. Only enable this if you are making edits theme, and need to see your changes every time you reload your page.
  • Compile templates if the files have been updated. PrestaShop is able to see when a theme file has changed, but this might not always work as expected.
  • Force compilation. The normal behavior: HTML pages are compiled and cached, even if the theme has changed.
• Cache. This option makes it possible for you to disable all file caches, and not just the one pertaining to template files. Only disable this if you debugging a theme or a module for PrestaShop. Otherwise, you should leave it enabled.
  The "Clear Smarty cache" makes it possible to delete the cache in a single click instead of having to go delete files on your FTP server.

[Xavier Borderie]

Hi Ricky,

 

Indeed! Well spotted! Somehow the first and third line were interverted long ago, and have not been corrected since then. Thank you very much!

I updated the page: http://doc.prestashop.com/pages/diffpagesbyversion.action?pageId=20578482&selectedPageVersions=7&selectedPageVersions=8

 

Best,

 

-xb.

[jonathbenz]

I have the same issue many times in the past, and can say with near certainty that it roots back to your templatedetails.xml file.

 

Cheap brochure printing Singapore

Edited October 11, 2014 by jonathbenz (see edit history)