diff --git a/doc_topics/01-introduction.md b/doc_topics/01-introduction.md
index 621375e..2193769 100644
--- a/doc_topics/01-introduction.md
+++ b/doc_topics/01-introduction.md
@@ -33,12 +33,11 @@ Here's a list of things to do when using this template:
     - Lua (`project`): "local prj = require '`project`'"
 
 
-* [Go to the template on Github and create a new repo from it](https://github.com/Tieske/project.lua/generate),
-  set the "`[short-description]`".
+* [Go to the template on Github and create a new repo from it](https://github.com/Tieske/project.lua/generate)
 
 * In the new repo settings, go to "Pages", and select branch "`main`" and folder "`/docs`".
 
-* On the main repo page edit the project details; add the link to the documentation.
+* On the main repo page edit the project details; set the "short-description" and add the link to the documentation.
 
 * Clone the repo locally.
 
diff --git a/docs/examples/example1.lua.html b/docs/examples/example1.lua.html
index 7543353..dc5f0af 100644
--- a/docs/examples/example1.lua.html
+++ b/docs/examples/example1.lua.html
@@ -27,6 +27,9 @@
 <h1>[repo-name]</h1>
 
 
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
 
 
 
@@ -36,7 +39,11 @@ <h2>Examples</h2>
 </ul>
 <h2>Modules</h2>
 <ul class="nowrap">
-  <li><a href="../index.html">project</a></li>
+  <li><a href="../modules/project.html">project</a></li>
+</ul>
+<h2>Scripts</h2>
+<ul class="nowrap">
+  <li><a href="../scripts/module-name.html">module-name</a></li>
 </ul>
 <h2>Topics</h2>
 <ul class="">
@@ -55,8 +62,8 @@ <h2>example1.lua</h2>
 <span class="comment">-- example to add to documentation
 </span>
 <span class="keyword">for</span> key, value <span class="keyword">in</span> <span class="global">pairs</span>(_G) <span class="keyword">do</span>
-  <span class="keyword">if</span> key:sub(<span class="number">1</span>,<span class="number">1</span>) == <span class="string">"_"</span> <span class="keyword">and</span> <span class="global">type</span>(value) == <span class="string">"string"</span> <span class="keyword">then</span>
-    key = key:match(<span class="string">"^_+(.+)$"</span>)
+  <span class="keyword">if</span> key:<span class="function-name">sub</span>(<span class="number">1</span>,<span class="number">1</span>) == <span class="string">"_"</span> <span class="keyword">and</span> <span class="global">type</span>(value) == <span class="string">"string"</span> <span class="keyword">then</span>
+    key = key:<span class="function-name">match</span>(<span class="string">"^_+(.+)$"</span>)
     <span class="global">print</span>(key, value)
   <span class="keyword">end</span>
 <span class="keyword">end</span></pre>
@@ -65,7 +72,8 @@ <h2>example1.lua</h2>
 </div> <!-- id="content" -->
 </div> <!-- id="main" -->
 <div id="about">
-<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-08-23 11:50:04 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/index.html b/docs/index.html
index 47046a5..2d6ac8f 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -28,15 +28,15 @@ <h1>[repo-name]</h1>
 
 
 
-<h2>Contents</h2>
-<ul>
-<li><a href="#Functions">Functions</a></li>
-</ul>
 
 
 <h2>Modules</h2>
 <ul class="nowrap">
-  <li><strong>project</strong></li>
+  <li><a href="modules/project.html">project</a></li>
+</ul>
+<h2>Scripts</h2>
+<ul class="nowrap">
+  <li><a href="scripts/module-name.html">module-name</a></li>
 </ul>
 <h2>Topics</h2>
 <ul class="">
@@ -54,82 +54,55 @@ <h2>Examples</h2>
 
 <div id="content">
 
-<h1>Module <code>project</code></h1>
-<p>This module does something.</p>
-<p> Explain some basics, or the design.</p>
-    <h3>Info:</h3>
-    <ul>
-        <li><strong>Copyright</strong>: Copyright (c) [copyright-year]-[copyright-year] [your-name]</li>
-        <li><strong>License</strong>: MIT, see <a href="topics/LICENSE.md.html#">LICENSE.md</a>.</li>
-        <li><strong>Author</strong>: [your-name]</li>
-    </ul>
 
+  <h2>[short-description]</h2>
 
-<h2><a href="#Functions">Functions</a></h2>
-<table class="function_list">
+<h2>Modules</h2>
+<table class="module_list">
 	<tr>
-	<td class="name" nowrap><a href="#do_something">do_something (what[, force=false])</a></td>
-	<td class="summary">Does something.</td>
+		<td class="name" nowrap><a href="modules/project.html">project</a></td>
+		<td class="summary">This module does something.</td>
+	</tr>
+</table>
+<h2>Scripts</h2>
+<table class="module_list">
+	<tr>
+		<td class="name" nowrap><a href="scripts/module-name.html">module-name</a></td>
+		<td class="summary">CLI application.</td>
+	</tr>
+</table>
+<h2>Topics</h2>
+<table class="module_list">
+	<tr>
+		<td class="name" nowrap><a href="topics/01-introduction.md.html">01-introduction.md</a></td>
+		<td class="summary"></td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="topics/02-advanced.md.html">02-advanced.md</a></td>
+		<td class="summary"></td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="topics/CHANGELOG.md.html">CHANGELOG.md</a></td>
+		<td class="summary"></td>
+	</tr>
+	<tr>
+		<td class="name" nowrap><a href="topics/LICENSE.md.html">LICENSE.md</a></td>
+		<td class="summary"></td>
+	</tr>
+</table>
+<h2>Examples</h2>
+<table class="module_list">
+	<tr>
+		<td class="name" nowrap><a href="examples/example1.lua.html">example1.lua</a></td>
+		<td class="summary"></td>
 	</tr>
 </table>
-
-<br/>
-<br/>
-
-
-    <h2 class="section-header "><a name="Functions"></a>Functions</h2>
-
-    <dl class="function">
-    <dt>
-    <a name = "do_something"></a>
-    <strong>do_something (what[, force=false])</strong>
-    </dt>
-    <dd>
-    Does something.
- It will do what you tell it.
-
-
-    <h3>Parameters:</h3>
-    <ul>
-        <li><span class="parameter">what</span>
-            <span class="types"><a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a> or <span class="type">function</span></span>
-         the thing that has to be done
-        </li>
-        <li><span class="parameter">force</span>
-            <span class="types"><span class="type">boolean</span></span>
-         set to a truthy value to force it.
-         (<em>default</em> false)
-        </li>
-    </ul>
-
-    <h3>Returns:</h3>
-    <ol>
-        <li>
-           <span class="types"><span class="type">boolean</span></span>
-        success</li>
-        <li>
-           <span class="types"><span class="type">nil</span> or <a class="type" href="https://www.lua.org/manual/5.1/manual.html#5.4">string</a></span>
-        error message on failure</li>
-    </ol>
-
-
-
-    <h3>Usage:</h3>
-    <ul>
-        <pre class="example"><span class="keyword">local</span> success, err = project.do_something(<span class="string">"tell a lie"</span>, <span class="keyword">true</span>)
-<span class="keyword">if</span> <span class="keyword">not</span> success <span class="keyword">then</span>
-    <span class="global">print</span>(<span class="string">"failed at lying; "</span>, err)
-<span class="keyword">end</span></pre>
-    </ul>
-
-</dd>
-</dl>
-
 
 </div> <!-- id="content" -->
 </div> <!-- id="main" -->
 <div id="about">
-<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-08-23 11:50:04 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/modules/project.html b/docs/modules/project.html
new file mode 100644
index 0000000..bf2cec6
--- /dev/null
+++ b/docs/modules/project.html
@@ -0,0 +1,86 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>[module-name] docs</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>[repo-name]</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+
+
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><strong>project</strong></li>
+</ul>
+<h2>Scripts</h2>
+<ul class="nowrap">
+  <li><a href="../scripts/module-name.html">module-name</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/01-introduction.md.html">1. Introduction</a></li>
+  <li><a href="../topics/02-advanced.md.html">2. Advanced topic</a></li>
+  <li><a href="../topics/CHANGELOG.md.html">CHANGELOG</a></li>
+  <li><a href="../topics/LICENSE.md.html">MIT License</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/example1.lua.html">example1.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+<h1>Module <code>project</code></h1>
+<p>This module does something.</p>
+<p> Explain some basics, or the design.</p>
+    <h3>Info:</h3>
+    <ul>
+        <li><strong>Copyright</strong>: Copyright (c) [copyright-year]-[copyright-year] [your-name]</li>
+        <li><strong>License</strong>: MIT, see <a href="../topics/LICENSE.md.html#">LICENSE.md</a>.</li>
+        <li><strong>Author</strong>: [your-name]</li>
+    </ul>
+
+
+
+<br/>
+<br/>
+
+
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-08-23 11:50:04 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/scripts/module-name.html b/docs/scripts/module-name.html
new file mode 100644
index 0000000..4d5ed3b
--- /dev/null
+++ b/docs/scripts/module-name.html
@@ -0,0 +1,86 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
+   "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html>
+<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
+<head>
+    <title>[module-name] docs</title>
+    <link rel="stylesheet" href="../ldoc.css" type="text/css" />
+</head>
+<body>
+
+<div id="container">
+
+<div id="product">
+	<div id="product_logo"></div>
+	<div id="product_name"><big><b></b></big></div>
+	<div id="product_description"></div>
+</div> <!-- id="product" -->
+
+
+<div id="main">
+
+
+<!-- Menu -->
+
+<div id="navigation">
+<br/>
+<h1>[repo-name]</h1>
+
+
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
+
+
+
+<h2>Scripts</h2>
+<ul class="nowrap">
+  <li><strong>module-name</strong></li>
+</ul>
+<h2>Modules</h2>
+<ul class="nowrap">
+  <li><a href="../modules/project.html">project</a></li>
+</ul>
+<h2>Topics</h2>
+<ul class="">
+  <li><a href="../topics/01-introduction.md.html">1. Introduction</a></li>
+  <li><a href="../topics/02-advanced.md.html">2. Advanced topic</a></li>
+  <li><a href="../topics/CHANGELOG.md.html">CHANGELOG</a></li>
+  <li><a href="../topics/LICENSE.md.html">MIT License</a></li>
+</ul>
+<h2>Examples</h2>
+<ul class="nowrap">
+  <li><a href="../examples/example1.lua.html">example1.lua</a></li>
+</ul>
+
+</div>
+
+<div id="content">
+
+<h1>Script <code>module-name</code></h1>
+<p>CLI application.</p>
+<p> Description goes here.</p>
+    <h3>Usage:</h3>
+    <ul>
+        <pre class="example"># start the application from a shell
+[module-name] --some --options=here
+</pre>
+    </ul>
+
+
+
+<br/>
+<br/>
+
+
+
+
+</div> <!-- id="content" -->
+</div> <!-- id="main" -->
+<div id="about">
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-08-23 11:50:04 </i>
+</div> <!-- id="about" -->
+</div> <!-- id="container" -->
+</body>
+</html>
diff --git a/docs/topics/01-introduction.md.html b/docs/topics/01-introduction.md.html
index df05b44..9378ebd 100644
--- a/docs/topics/01-introduction.md.html
+++ b/docs/topics/01-introduction.md.html
@@ -27,6 +27,9 @@
 <h1>[repo-name]</h1>
 
 
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
 
 <h2>Contents</h2>
 <ul>
@@ -47,7 +50,11 @@ <h2>Topics</h2>
 </ul>
 <h2>Modules</h2>
 <ul class="nowrap">
-  <li><a href="../index.html">project</a></li>
+  <li><a href="../modules/project.html">project</a></li>
+</ul>
+<h2>Scripts</h2>
+<ul class="nowrap">
+  <li><a href="../scripts/module-name.html">module-name</a></li>
 </ul>
 <h2>Examples</h2>
 <ul class="nowrap">
@@ -92,24 +99,23 @@ <h2>1.2 Getting started</h2>
 <ul>
     <li>pick a name for your project. Check on Github and LuaRocks that the name is available.
     A common pattern for naming is to use a <code>.lua</code> extension on Github, and the plain
-    name for LuaRocks and when using <a href="https://www.lua.org/manual/5.1/manual.html#pdf-require">require</a>. So for this template:</li>
+    name for LuaRocks and when using <a href="https://www.lua.org/manual/5.4/manual.html#pdf-require">require</a>. So for this template:</li>
 </ul>
 
 
 <pre>
-- Github (<span class="backtick"><code>project.lua</code></span>): <span class="string">"https://github.com/Tieske/<code>project.lua</code>.git"</span>
-- LuaRocks (<span class="backtick"><a href="../index.html#">project</a></span>): <span class="string">"luarocks install <a href="../index.html#">project</a>"</span>
-- Lua (<span class="backtick"><a href="../index.html#">project</a></span>): <span class="string">"local prj = require '<a href="../index.html#">project</a>'"</span>
+- <span class="function-name">Github</span> (<span class="backtick"><code>project.lua</code></span>): <span class="string">"https://github.com/Tieske/<code>project.lua</code>.git"</span>
+- <span class="function-name">LuaRocks</span> (<span class="backtick"><a href="../modules/project.html#">project</a></span>): <span class="string">"luarocks install <a href="../modules/project.html#">project</a>"</span>
+- <span class="function-name">Lua</span> (<span class="backtick"><a href="../modules/project.html#">project</a></span>): <span class="string">"local prj = require '<a href="../modules/project.html#">project</a>'"</span>
 </pre>
 
-<p>* <a href="https://github.com/Tieske/project.lua/generate">Go to the template on Github and create a new repo from it</a>,
-  set the "<code>[short-description]</code>".</p>
+<p>* <a href="https://github.com/Tieske/project.lua/generate">Go to the template on Github and create a new repo from it</a></p>
 
 <ul>
     <li><p>In the new repo settings, go to "Pages", and select branch "<code>main</code>" and folder "<code>/docs</code>".</p></li>
-    <li><p>On the main repo page edit the project details; add the link to the documentation.</p></li>
+    <li><p>On the main repo page edit the project details; set the "short-description" and add the link to the documentation.</p></li>
     <li><p>Clone the repo locally.</p></li>
-    <li><p>Run the interactive <code>init.sh</code> script.</p></li>
+    <li><p>Run <code>make</code> and follow the interactive prompts to initialize the repo.</p></li>
     <li><p>Commit all changes, and push to the repo.</p></li>
 </ul>
 
@@ -146,7 +152,8 @@ <h2>1.4 The Makefile</h2>
     LuaRocks).</li>
     <li><code>doc</code>: will re-render the docs (will remove the existing docs first, so use this over the
     <code>ldoc .</code> command to prevent orphaned files in the docs tree).</li>
-    <li><code>dev</code> will install the required development dependencies using LuaRocks (busted, luacheck,
+    <li><code>deps</code>: installs the module dependencies</li>
+    <li><code>dev</code>: installs the required development dependencies using LuaRocks (busted, luacheck,
     ldoc, and luacov).</li>
 </ul>
 
@@ -301,7 +308,8 @@ <h3>1.5.13 Documentation in/from  "<code>./docs</code>", "<code>./doc_topics</co
 </div> <!-- id="content" -->
 </div> <!-- id="main" -->
 <div id="about">
-<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-08-23 11:50:04 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/topics/02-advanced.md.html b/docs/topics/02-advanced.md.html
index 73a72a6..1bc70d2 100644
--- a/docs/topics/02-advanced.md.html
+++ b/docs/topics/02-advanced.md.html
@@ -27,6 +27,9 @@
 <h1>[repo-name]</h1>
 
 
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
 
 
 
@@ -39,7 +42,11 @@ <h2>Topics</h2>
 </ul>
 <h2>Modules</h2>
 <ul class="nowrap">
-  <li><a href="../index.html">project</a></li>
+  <li><a href="../modules/project.html">project</a></li>
+</ul>
+<h2>Scripts</h2>
+<ul class="nowrap">
+  <li><a href="../scripts/module-name.html">module-name</a></li>
 </ul>
 <h2>Examples</h2>
 <ul class="nowrap">
@@ -59,7 +66,8 @@ <h1>2. Advanced topic</h1>
 </div> <!-- id="content" -->
 </div> <!-- id="main" -->
 <div id="about">
-<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-08-23 11:50:04 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/topics/CHANGELOG.md.html b/docs/topics/CHANGELOG.md.html
index cb83a79..a8f871c 100644
--- a/docs/topics/CHANGELOG.md.html
+++ b/docs/topics/CHANGELOG.md.html
@@ -27,7 +27,15 @@
 <h1>[repo-name]</h1>
 
 
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
 
+<h2>Contents</h2>
+<ul>
+<li><a href="#Versioning">Versioning </a></li>
+<li><a href="#Version_history">Version history </a></li>
+</ul>
 
 
 <h2>Topics</h2>
@@ -39,7 +47,11 @@ <h2>Topics</h2>
 </ul>
 <h2>Modules</h2>
 <ul class="nowrap">
-  <li><a href="../index.html">project</a></li>
+  <li><a href="../modules/project.html">project</a></li>
+</ul>
+<h2>Scripts</h2>
+<ul class="nowrap">
+  <li><a href="../scripts/module-name.html">module-name</a></li>
 </ul>
 <h2>Examples</h2>
 <ul class="nowrap">
@@ -53,12 +65,25 @@ <h2>Examples</h2>
 
 <h1>CHANGELOG</h1>
 
+<p><a name="Versioning"></a></p>
+<h2>Versioning</h2>
+
+<p>This library is versioned based on Semantic Versioning (<a href="https://semver.org/">SemVer</a>).</p>
+
+<h4>Version scoping</h4>
+
+<p>The scope of what is covered by the version number excludes:</p>
+
+<ul>
+    <li>error messages; the text of the messages can change, unless specifically documented.</li>
+</ul>
+
 <h4>Releasing new versions</h4>
 
 <ul>
     <li>create a release branch</li>
     <li>update the changelog below</li>
-    <li>update version and copyright-years in <code>./LICENSE</code> and <code>./src/[module-name]/init.lua</code> (in doc-comments
+    <li>update version and copyright-years in <code>./LICENSE.md</code> and <code>./src/[module-name]/init.lua</code> (in doc-comments
     header, and in module constants)</li>
     <li>create a new rockspec and update the version inside the new rockspec:<br/>
     <code>cp [module-name]-scm-1.rockspec ./rockspecs/[module-name]-X.Y.Z-1.rockspec</code></li>
@@ -73,6 +98,9 @@ <h4>Releasing new versions</h4>
     <code>luarocks install [module-name]</code></li>
 </ul>
 
+<p><a name="Version_history"></a></p>
+<h2>Version history</h2>
+
 <h3>Version X.Y.Z, unreleased</h3>
 
 <ul>
@@ -90,7 +118,8 @@ <h3>Version 0.1.0, released 01-Jan-2022</h3>
 </div> <!-- id="content" -->
 </div> <!-- id="main" -->
 <div id="about">
-<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-08-23 11:50:04 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>
diff --git a/docs/topics/LICENSE.md.html b/docs/topics/LICENSE.md.html
index 19a0c5b..7f6eace 100644
--- a/docs/topics/LICENSE.md.html
+++ b/docs/topics/LICENSE.md.html
@@ -27,6 +27,9 @@
 <h1>[repo-name]</h1>
 
 
+<ul>
+  <li><a href="../index.html">Index</a></li>
+</ul>
 
 
 
@@ -39,7 +42,11 @@ <h2>Topics</h2>
 </ul>
 <h2>Modules</h2>
 <ul class="nowrap">
-  <li><a href="../index.html">project</a></li>
+  <li><a href="../modules/project.html">project</a></li>
+</ul>
+<h2>Scripts</h2>
+<ul class="nowrap">
+  <li><a href="../scripts/module-name.html">module-name</a></li>
 </ul>
 <h2>Examples</h2>
 <ul class="nowrap">
@@ -77,7 +84,8 @@ <h3>Copyright (c) [copyright-year]-[copyright-year] [your-name]</h3>
 </div> <!-- id="content" -->
 </div> <!-- id="main" -->
 <div id="about">
-<i>generated by <a href="http://github.com/stevedonovan/LDoc">LDoc 1.4.6</a></i>
+<i>generated by <a href="http://github.com/lunarmodules/ldoc">LDoc 1.5.0</a></i>
+<i style="float:right;">Last updated 2026-08-23 11:50:04 </i>
 </div> <!-- id="about" -->
 </div> <!-- id="container" -->
 </body>