diff --git a/doc/src/declarative.md b/doc/src/declarative.md
index a896202b..1eafa9ff 100644
--- a/doc/src/declarative.md
+++ b/doc/src/declarative.md
@@ -52,7 +52,7 @@ nixos-containers work if you are familiar with those.
 ## Declarative deployment
 
 Why *deployed*? The per-MicroVM subdirectory under `/var/lib/microvms`
-is only created, if it did not exist before. This behavior is
+is only created if it did not exist before. This behavior is
 intended to ensure existence of MicroVMs that are critical to
 operation. To update them later you will have to use the [imperative microvm
 command](./microvm-command.md).
diff --git a/doc/src/shares.md b/doc/src/shares.md
index c3730d5f..dbe1dd7a 100644
--- a/doc/src/shares.md
+++ b/doc/src/shares.md
@@ -55,7 +55,9 @@ don't work currently, so resort to using a volume for that:
 }
 ```
 
-**Caveat:** The Nix database will forget all built packages after a
+<div class="warning">
+The Nix database will forget all built packages after a
 reboot, containing only what is needed for the VM's NixOS
 system. Until this has been solved, it is recommended to just delete
 and recreate the overlay after MicroVM shutdown or before startup.
+</div>