From 061611d09d8e3c83e43486bbe79ccd052c19314a Mon Sep 17 00:00:00 2001
From: glyph <glyph@mycelial.technology>
Date: Fri, 26 Nov 2021 11:08:59 +0200
Subject: [PATCH] more doc comments

---
 src/lib.rs  | 5 ++++-
 src/main.rs | 2 ++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/lib.rs b/src/lib.rs
index e00467b..28e94ec 100644
--- a/src/lib.rs
+++ b/src/lib.rs
@@ -1,3 +1,5 @@
+#![warn(missing_docs)]
+
 //! # nyf
 //!
 //! _glyph's static site generator_
@@ -20,7 +22,7 @@
 //! `./site` directory (preserving the sub-directory structure). The contents of the `<h2>`
 //! element are spliced into the `[[ title ]]` tag of the base HTML template for each
 //! sub-directory template.
-//!
+
 use std::{fs, io, path::Path};
 
 // define the path for the template directory
@@ -28,6 +30,7 @@ const TEMPLATE_DIR: &str = "./templates";
 // define the path for the generated site output
 const SITE_DIR: &str = "./site";
 
+/// Run (with the) `nyf`.
 pub fn run() -> Result<(), &'static str> {
     // read the base html template to a string
     let base = format!("{}/base.html", TEMPLATE_DIR);
diff --git a/src/main.rs b/src/main.rs
index 7f843e2..39851c1 100644
--- a/src/main.rs
+++ b/src/main.rs
@@ -1,5 +1,7 @@
 use std::process;
 
+/// Begin the `nyf` run. Catch any application errors, print them to `stderr` and return an error
+/// exit code (`1`).
 fn main() {
     if let Err(e) = nyf::run() {
         eprintln!("{}", e);