Restructure plop-dir documentation

.changeset/eight-phones-rescue.md

@@ -0,0 +1,5 @@
+---
+'plop-dir': patch
+---
+
+Restructure documentation

packages/plop-dir/README.md

@@ -20,17 +20,29 @@ npm i -D plop plop-dir
 
 ## Usage
 
-`plop-dir` fits into your existing `plop` workflow
+### Example templates directory:
 
-**`plopfile.mjs`**
+```
+plopfile.mjs
+src/
+templates/
+|__ my-template/
+   |-- {{kebabCase templateName}}.js
+   |__ tests/
+      |__ {{kebabCase templateName}}.test.js
+```
+
+### `plopfile.mjs`
+
+`plop-dir` fits into your existing `plop` workflow
 
 ```mjs
 import * as url from 'node:url'
 import * as path from 'node:path'
 
 import { plopDir } from 'plop-dir'
 
-const __dirname = url.fileURLToPath(new URL('.', import.meta.url))
+const __dirname = path.dirname(url.fileURLToPath(import.meta.url))
 
 /** @param {import('plop').NodePlopAPI} plop */
 export default async function run(plop) {
@@ -56,33 +68,21 @@ export default async function run(plop) {
 
 > Note: Currently, `plopDir` is only supported in asynchronous `plopfile`s
 
-Example template directory:
-
-> See the [plop docs](https://plopjs.com/documentation/#case-modifiers) for all
-> available case modifiers
-
-```
-plopfile.mjs
-src/
-templates/
-|__ my-template/
-   |-- {{kebabCase templateName}}.js
-   |__ tests/
-      |__ {{kebabCase templateName}}.test.js
-```
-
-Example template file `my-template/tests/{{kebabCase templateName}}.js`:
-
-> See the [plop docs](https://plopjs.com/documentation/#case-modifiers) for all
-> available case modifiers
+### Example template file: `my-template/tests/{{kebabCase templateName}}.js`
 
 ```js
 export default function {{camelCase testName}}() {
   return '{{pascalCase templateName}}'
 }
 ```
 
-Run the `plop` CLI:
+Note: `testName` is extracted from the file content (e.g.
+`{{camelCase testName}}`) and included as a `plop` prompt
+
+> See the [plop docs](https://plopjs.com/documentation/#case-modifiers) for all
+> available case modifiers
+
+### Run the `plop` CLI:
 
 ```sh
 $ npm run plop my-template