Quickpi useless blocks

README.md

@@ -4,6 +4,25 @@ This repository contains a static directory structure used in [Bebras tasks](htt
 
 This would be usually considered bad (or outdated) practice, but it addresses a requirement: allow people who are not experts in JavaScript tools (who cannot install `npm`, `bower`, etc.) to have a development environment for Bebras tasks.
 
+## Bundles
+
+To optimise loading of files, this directory also contains bundles, which can be used in place of importing the corresponding JS files.
+
+To define a bundle, you must, in `importModules*.js` :
+
+* add how to import the bundle to `importableModules`
+* add the list of modules this bundle includes in `bundledModules`
+
+and then, include, in `gulpfile.js`, the list of files to include in this bundle.
+
+The command
+```
+gulp bundles
+```
+will then generate all bundles into the subfolder `bundles/`.
+
+While testing this feature, bundles are loaded by `importModules*.js` only if `window.useBundles` is `true`.
+
 ### TODO
 
 - find a better solution?