Readme.md in web_resource_bundler-0.0.22 vs Readme.md in web_resource_bundler-0.0.23
- old
+ new
@@ -103,16 +103,17 @@
Recommendations
--------------------
1. Be mindful while organazing and linking your resource files
WebResourceBundler combines all resource file in one. This resulted file could be huge.
- a. Don't link all resources in layouts!
+
+ * Don't link all resources in layouts!
Be sure to link resources (css\js) only for pages that using them, in other case your users will be forced
to download huge css\js files with unused content.
- b. One css for one page.
+ * One css for one page.
Try to slice you css files - separate file for each particular page.
- c. Separate bundle block for crucial resources
+ * Separate bundle block for crucial resources
To make crucial resources (basic styles\scripts for user can see basic page layout ASAP) load first - just bundle them in separate web_resource_bundler_process block and put this block at the top of your head block.
2. Don't set max_image_size to big values.
The main reason of using Base64 filter is to avoid unnecessary server requests and minimize load time,
but when encoded image is very big, traffic overhead time (encoded image base64 code is bigger for apprx. 30% than source image size) could be bigger than request time. In this case your site could be even slower than without a WebResourceBundler.
@@ -122,7 +123,8 @@
Some third party javascript libs can load another script file on the fly, relative path for this file computed
on the client side. But your scripts are bundled and their relative path changed (cache folder), that's why such script
won't be able to compute loaded file path correctly. You should avoid bundling such tricky javascripts.
4. Unexistent resources handling
- a. Be sure to link in html only existent resource files, otherwise bundler won't work.
- b. If you have unexistent images in css, bundler will work but you've got info messages in log.
+
+ * Be sure to link in html only existent resource files, otherwise bundler won't work.
+ * If you have unexistent images in css, bundler will work but you've got info messages in log.