diff --git a/README.md b/README.md
index 3272947..4196340 100644
--- a/README.md
+++ b/README.md
@@ -57,8 +57,9 @@ However, try changing your engine to LuaLaTeX if something breaks.
 
 # 📜 Class Documentation
 
-The class `ormc_handout` is based on `article.cls`, and should work with most packages.\
-If something breaks, tell me so I may try to fix it.
+The class `ormc_handout` is based on `article.cls`, and should work with most LaTeX packages. It has everything you need and nothing you don't; it looks pretty and it is optimized for greyscale printing.
+
+If you find something broken, please tell me so I may try to fix it.
 
 
 
@@ -66,6 +67,7 @@ If something breaks, tell me so I may try to fix it.
 
 These are passed to `\documentclass`, as follows:
 ```latex
+% Documentclass argument example
 \documentclass[
 	nosolutions,
 	shortwarning