Update class documentation

README.md

@@ -88,7 +88,7 @@ That's complicated and specific to the application.  Some examples:
 Not secrets:
 
 * Digest output.  Except when used for key derivation, then it's a Secret, including the Digest state
-* IO::Memory or writing a file.  Except when the file is a password vault, cryptocurrency wallet, encrypted mail/messages, goat porn, maybe "normal" porn, sometimes scat porn, occassionally furry, not vanilla porn
+* IO::Memory or writing a file.  Except when the file is a password vault, cryptocurrency wallet, encrypted mail/messages, goat porn, maybe "normal" porn, sometimes scat porn, occassionally furry, not people porn
 
 ## Why?
 

src/crypto-secret/bidet.cr

@@ -1,11 +1,11 @@
 require "./stateless"
 
-# Leaves less sh** around if you forget to wipe.  A safer default for large secrets that may stress mlock limits or low confidentiality secrets.
-#
-# * Not locked in memory
-# * Not access protected
-# * No guard pages
 module Crypto::Secret
+  # Leaves less sh** around if you forget to wipe.  A safer default for large secrets that may stress mlock limits or low confidentiality secrets.
+  #
+  # * Not locked in memory
+  # * Not access protected
+  # * No guard pages
   class Bidet
     include Stateless
 

src/crypto-secret/not.cr

@@ -1,13 +1,13 @@
 require "./stateless"
 
-# A not very secret secret, but fast
-#
-# * 0 overhead
-# * Not locked in memory
-# * Not access protected
-# * No guard pages
-# * No wiping
 module Crypto::Secret
+  # A not very secret `Secret`, but fast
+  #
+  # * 0 overhead
+  # * Not locked in memory
+  # * Not access protected
+  # * No guard pages
+  # * No wiping
   struct Not
     include Stateless