summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Mehren2019-10-25 20:52:15 +0200
committerDavid Mehren2019-10-25 20:52:15 +0200
commitb714baa36ee3317082dac71a166986d6afb35b07 (patch)
treee6c7f6e90fcac8e3e50d40d1db92a89d28a71dae
parent20a67e3446723231961043bffeb5a7b974e891c0 (diff)
Improve webpack dev documentation
Signed-off-by: David Mehren <dmehren1@gmail.com>
-rw-r--r--docs/dev/webpack.md9
1 files changed, 8 insertions, 1 deletions
diff --git a/docs/dev/webpack.md b/docs/dev/webpack.md
index b05fd1d3..3d35b28a 100644
--- a/docs/dev/webpack.md
+++ b/docs/dev/webpack.md
@@ -7,7 +7,14 @@ about it on [the webpack website](https://webpack.js.org/).
Here's how we're using it:
## `webpack.common.js`
-This file contains all common definition for chunks and plugins, that are needed by the whole app.
+This file contains all common definitions for chunks and plugins that are needed by the whole app.
+
+The various entrypoints under the `entry` key define groups of files (npm packages or .css/.js files directly from this project) that need to be included together to be useful.
+The `index` group for example bundles all javascript files and libraries used for the note editor.
+
+Entrypoints are referenced in the `plugins` section.
+The `HtmlWebpackPlugin` uses templates in `public/views/includes` to include the path to the generated resources in new templates under `public/views/build`. These templates are then used by the backend to serve HTML to the browser.
+
**TODO:** Document which entry points are used for what.