Improve documentation

docs/integrate-esm.md

@@ -0,0 +1,78 @@
+## Integrating the ESM version of the Monaco Editor
+
+### Using webpack
+
+Here is the most basic script that imports the editor using ESM with webpack.
+
+More self-contained samples are available at [monaco-editor-samples](https://github.com/Microsoft/monaco-editor-samples).
+
+* `index.js`
+```js
+import * as monaco from 'monaco-editor';
+
+// Since packaging is done by you, you need
+// to instruct the editor how you named the
+// bundles that contain the web workers.
+self.MonacoEnvironment = {
+    getWorkerUrl: function (moduleId, label) {
+        if (label === 'json') {
+            return './json.worker.bundle.js';
+        }
+        if (label === 'css') {
+            return './css.worker.bundle.js';
+        }
+        if (label === 'html') {
+            return './html.worker.bundle.js';
+        }
+        if (label === 'typescript') {
+            return './ts.worker.bundle.js';
+        }
+        return './editor.worker.bundle.js';
+    }
+}
+
+monaco.editor.create(document.getElementById('container'), {
+    value: [
+        'function x() {',
+        '\tconsole.log("Hello world!");',
+        '}'
+    ].join('\n'),
+    language: 'javascript'
+});
+```
+
+* `webpack.config.js`:
+```js
+const path = require('path');
+const webpack = require('webpack');
+
+module.exports = {
+    entry: {
+        "app": './index.js',
+        // Package each language's worker and give these filenames in `getWorkerUrl`
+        "editor.worker": 'monaco-editor/esm/vs/editor/editor.worker.js',
+        "json.worker": 'monaco-editor/esm/vs/language/json/json.worker',
+        "css.worker": 'monaco-editor/esm/vs/language/css/css.worker',
+        "html.worker": 'monaco-editor/esm/vs/language/html/html.worker',
+        "ts.worker": 'monaco-editor/esm/vs/language/typescript/ts.worker',
+    },
+    output: {
+        filename: '[name].bundle.js',
+        path: path.resolve(__dirname, 'dist')
+    },
+    module: {
+        rules: [{
+            test: /\.css$/,
+            use: [ 'style-loader', 'css-loader' ]
+        }]
+    },
+    plugins: [
+        // Ignore require() calls in vs/language/typescript/lib/typescriptServices.js
+        new webpack.IgnorePlugin(
+            /^((fs)|(path)|(os)|(crypto)|(source-map-support))$/,
+            /vs\/language\/typescript\/lib/
+        )
+    ]
+};
+
+```