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"
 
+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
-module Crypto::Secret
   class Bidet
     include Stateless
 

src/crypto-secret/not.cr

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