From 0360a1df20106ec44d361bf3dac94dd168d66a03 Mon Sep 17 00:00:00 2001
From: Bertrand Guay-Paquet <berniegp@gmail.com>
Date: Sat, 30 Jul 2022 07:12:25 +0200
Subject: [PATCH] [v3.0] Port doc changes from #4572 and #4583 to 3.0 (#4592)

---
 docs/01-command-line-reference.md | 26 ++++++++------------------
 1 file changed, 8 insertions(+), 18 deletions(-)

diff --git a/docs/01-command-line-reference.md b/docs/01-command-line-reference.md
index ddef8477387..e097e18ed8a 100755
--- a/docs/01-command-line-reference.md
+++ b/docs/01-command-line-reference.md
@@ -305,30 +305,19 @@ It can be useful to import your package file to e.g. mark your dependencies as "
   import pkg from './package.json' assert { type: 'json' };
 
   export default {
-    input: 'src/main.js',
-    external: Object.keys(pkg.dependencies),
-    output: {
-      format: 'es',
-      dir: 'dist'
-    }
+    // Mark package dependencies as "external". Rest of configuration omitted.
+    external: Object.keys(pkg.dependencies)
   };
   ```
 
-- For older Node versions, you can use "createRequire"
+- For older Node versions, you can use `createRequire`
 
   ```js
   import { createRequire } from 'module';
   const require = createRequire(import.meta.url);
   const pkg = require('./package.json');
 
-  export default {
-    input: 'src/main.js',
-    external: Object.keys(pkg.dependencies),
-    output: {
-      format: 'es',
-      dir: 'dist'
-    }
-  };
+  // ...
   ```
 
 - Or just directly read and parse the file from disk
@@ -336,10 +325,11 @@ It can be useful to import your package file to e.g. mark your dependencies as "
   ```js
   // rollup.config.mjs
   import { readFileSync } from 'fs';
-  import { fileURLToPath } from 'url';
 
-  const pkgFileName = fileURLToPath(new URL('./package.json', import.meta.url));
-  const pkg = JSON.parse(readFileSync(pkgFileName));
+  // Use import.meta.url to make the path relative to the current source file instead of process.cwd()
+  // For more info: https://nodejs.org/docs/latest-v16.x/api/esm.html#importmetaurl
+  const packageJson = JSON.parse(readFileSync(new URL('./package.json', import.meta.url)));
+
   // ...
   ```