docpensieve 0.1.2 → 0.1.3

package/README.md

@@ -32,6 +32,18 @@ The development server reloads the browser after every rebuild, through a
 script injected **at serving time**: the output of `build` stays free of
 JavaScript.
 
+## Updating
+
+```bash
+npm install docpensieve@latest
+```
+
+Run through `npx` alone, it needs nothing: `npx docpensieve` fetches the
+latest version by itself. A project set up with 0.1.0 can rename
+`docpensieve.config.js` to `docpensieve.config.mjs`, which Node reads as a
+module whatever the `package.json` says: the warning printed on every build
+goes away.
+
 ## Documentation
 
 See the [repository](https://github.com/Juniors017/docpensieve#readme).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docpensieve",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "DocPensieve command-line interface (init, build, check, dev, serve)",
   "type": "module",
   "license": "MIT",
@@ -24,10 +24,10 @@
     "types"
   ],
   "dependencies": {
-    "@docpensieve/components": "0.1.2",
-    "@docpensieve/core": "0.1.2",
-    "@docpensieve/shared": "0.1.2",
-    "@docpensieve/theme": "0.1.2",
+    "@docpensieve/components": "0.1.3",
+    "@docpensieve/core": "0.1.3",
+    "@docpensieve/shared": "0.1.3",
+    "@docpensieve/theme": "0.1.3",
     "chalk": "^6.0.0",
     "chokidar": "^5.0.0",
     "commander": "^15.0.0"

package/src/commands/init.js

@@ -127,9 +127,19 @@ async function collect(options) {
     docs: !options.minimal,
   };
 
+  if (options.yes) return fromOptions;
+
   // Without a terminal — script, CI, pipe — the dialogue would never complete:
-  // stick to the options and the defaults.
-  if (options.yes || !process.stdin.isTTY) return fromOptions;
+  // stick to the options and the defaults. But say so: some terminals run
+  // programs without handing them one, and the questions used to vanish
+  // without a word, the defaults going unnoticed.
+  if (!process.stdin.isTTY) {
+    console.log('No interactive terminal: no questions asked, the options and defaults apply.');
+    console.log(
+      'To choose, pass --name, --site-url, --theme, --version-name or --minimal; --yes silences this notice.',
+    );
+    return fromOptions;
+  }
 
   const rl = createInterface({ input: process.stdin, output: process.stdout });
   try {

package/starter/01-guide/01-installation.md

@@ -26,7 +26,9 @@ cd my-site
 
 The command creates the folder and writes a configuration, a first
 documentation folder and a home page into it. It asks a few questions; `--yes`
-skips them and accepts the defaults.
+skips them and accepts the defaults. Where it cannot ask — a script, continuous
+integration, or a terminal that gives the programs it runs no interactive
+input — it says so and sticks to the options and the defaults.
 
 It also installs this very documentation, in a **DocPensieve** section at the
 end of the new site's menu. It matches the version you installed, and its
@@ -69,6 +71,23 @@ Both are equivalent in use — the templates are the same, only the styling
 changes. The choice is not final: it fits in one field of the configuration,
 described in [Themes](./themes/).
 
+## Updating
+
+```bash
+npm install docpensieve@latest
+```
+
+Run through `npx` alone, DocPensieve needs nothing: `npx docpensieve` fetches
+the latest version by itself.
+
+A project set up with 0.1.0 has a `docpensieve.config.js`. It still works, but
+Node reads it as a module only when the `package.json` says so, and warns on
+every build otherwise: rename it `docpensieve.config.mjs`.
+
+The documentation `init` installed in `99-docpensieve` stays at the version it
+came with. To refresh it, run `init` in a scratch folder and copy that folder
+over.
+
 ## Checking
 
 ```bash

package/starter/03-reference/01-cli.md

@@ -35,6 +35,11 @@ npx docpensieve init [dir]
 
 Without `--force`, the command refuses to overwrite an existing configuration.
 
+Without an interactive terminal — a script, continuous integration, or a
+terminal that gives the programs it runs no interactive input — the command
+asks nothing: it says so, then sticks to the options and the defaults. `--yes`
+makes that choice explicit and silences the notice.
+
 Unless `--minimal` is given, the command installs DocPensieve's documentation
 in the new site, in `docs/<version>/99-docpensieve/`: a **DocPensieve** section
 at the end of the menu, matching the installed version. Delete that folder when