fix docs

Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "ocsp-stapler"
-version = "0.3.0"
+version = "0.3.1"
 edition = "2021"
 license = "MPL-2.0"
 description = "OCSP stapler & client with support for Rustls"
@@ -15,7 +15,7 @@ categories = [
     "web-programming::http-server",
 ]
 
-readme = "README_CARGO.md"
+readme = "README_DOCS.md"
 
 [dependencies]
 anyhow = "1.0"
@@ -51,3 +51,6 @@ num-bigint = "0.4"
 
 [lib]
 doctest = false
+
+[build-dependencies]
+readme-rustdocifier = "0.1.0"

README_CARGO.md → README_DOCS.md

@@ -43,7 +43,7 @@ Other notes:
 
 Stapler supports a few Prometheus metrics - create it using one of `new_..._with_registry()` constructors and provide a Prometheus `Registry` reference to register the metrics in.
 
-# Example
+### Example
 
 ```rust,ignore
 // Inner service that provides certificates to Rustls, can be anything

build.rs

@@ -0,0 +1,19 @@
+use std::{env, error::Error, fs, path::PathBuf};
+
+const CRATE_NAME: &str = "ocsp-stapler";
+
+fn main() -> Result<(), Box<dyn Error>> {
+    println!("cargo:rerun-if-changed=README_DOCS.md");
+
+    fs::write(
+        PathBuf::from(env::var("OUT_DIR")?).join("README-rustdocified.md"),
+        readme_rustdocifier::rustdocify(
+            &fs::read_to_string("README_DOCS.md")?,
+            &env::var("CARGO_PKG_NAME")?,
+            Some(&env::var("CARGO_PKG_VERSION")?),
+            Some(CRATE_NAME),
+        )?,
+    )?;
+
+    Ok(())
+}

src/lib.rs

@@ -1,5 +1,6 @@
 #![warn(clippy::all)]
 #![warn(clippy::nursery)]
+#![doc = include_str!(concat!(env!("OUT_DIR"), "/README-rustdocified.md"))]
 
 pub mod client;
 pub mod stapler;

src/stapler.rs

@@ -355,11 +355,16 @@ impl StaplerActor {
             .context("unable to parse certificate as X.509")?
             .1;
 
-        let cert_validity =
-            Validity::try_from(&cert.validity).context("unable to parse certificate validity")?;
+        let cert_validity = Validity::try_from(&cert.validity).context(format!(
+            "unable to parse certificate [{}] validity",
+            cert.subject
+        ))?;
 
         if !cert_validity.valid(Utc::now().into()) {
-            return Err(anyhow!("The certificate is not valid at current time"));
+            return Err(anyhow!(
+                "the certificate [{}] is not valid at current time",
+                cert.subject
+            ));
         }
 
         let cert = Cert {