clarify deletion behavior of output-dir (closes #13896)

Author: petrelharp

src/command/render/cmd.ts

@@ -37,7 +37,7 @@ export const renderCommand = new Command()
   )
   .option(
     "--output-dir",
-    "Write output to DIR (path is input/project relative)",
+    "Write output to DIR, which is first deleted (path is input/project relative)",
   )
   .option(
     "-M, --metadata",
@@ -89,7 +89,7 @@ export const renderCommand = new Command()
   )
   .option(
     "--no-clean",
-    "Do not clean project output-dir prior to render",
+    "Do not delete output-dir prior to render",
   )
   .option(
     "--debug",

src/resources/schema/project.yml

@@ -24,7 +24,11 @@
               - `project`: Use the root directory of the project.
         output-dir:
           path:
-            description: "Output directory"
+            description:
+              short: "Output directory"
+              long: >
+              The directory in which all outputs are placed. If a directory with this name
+              already exists, it will be deleted and replaced with a new directory.
         lib-dir:
           path:
             description: "HTML library (JS/CSS/etc.) directory"