diff --git a/doc_config/yard/templates/default/fulldoc/html/css/global.css b/doc_config/yard/templates/default/fulldoc/html/css/global.css
index 26f58aa0..8e414c02 100644
--- a/doc_config/yard/templates/default/fulldoc/html/css/global.css
+++ b/doc_config/yard/templates/default/fulldoc/html/css/global.css
@@ -61,6 +61,8 @@ blockquote p {
   line-height: inherit;
 }
 
+/*
 ul ul, ol ol, ul ol, ol ul {
   margin-bottom: 1.25em;
 }
+*/
diff --git a/lib/shoulda/matchers/action_controller.rb b/lib/shoulda/matchers/action_controller.rb
index bbd59859..91dd016f 100644
--- a/lib/shoulda/matchers/action_controller.rb
+++ b/lib/shoulda/matchers/action_controller.rb
@@ -16,6 +16,8 @@ require 'shoulda/matchers/action_controller/session_store'
 
 module Shoulda
   module Matchers
+    # This module provides matchers that are used to test behavior within
+    # controllers.
     module ActionController
     end
   end
diff --git a/lib/shoulda/matchers/active_model.rb b/lib/shoulda/matchers/active_model.rb
index 7cb1cd45..cab68545 100644
--- a/lib/shoulda/matchers/active_model.rb
+++ b/lib/shoulda/matchers/active_model.rb
@@ -32,9 +32,8 @@ require 'shoulda/matchers/active_model/have_secure_password_matcher'
 
 module Shoulda
   module Matchers
-    # This mixin provides matchers that are used to test behavior, such as
-    # validations, that you've added to your ActiveModel (or ActiveRecord)
-    # objects.
+    # This module provides matchers that are used to test behavior within
+    # ActiveModel or ActiveRecord classes.
     #
     # ### Testing conditional validations
     #
diff --git a/lib/shoulda/matchers/active_record.rb b/lib/shoulda/matchers/active_record.rb
index 61a38227..00d30a92 100644
--- a/lib/shoulda/matchers/active_record.rb
+++ b/lib/shoulda/matchers/active_record.rb
@@ -24,6 +24,8 @@ require "shoulda/matchers/active_record/validate_uniqueness_of_matcher"
 
 module Shoulda
   module Matchers
+    # This module provides matchers that are used to test behavior within
+    # ActiveRecord classes.
     module ActiveRecord
     end
   end
diff --git a/lib/shoulda/matchers/independent.rb b/lib/shoulda/matchers/independent.rb
index 3b2a6b7c..3996e023 100644
--- a/lib/shoulda/matchers/independent.rb
+++ b/lib/shoulda/matchers/independent.rb
@@ -4,7 +4,8 @@ require 'shoulda/matchers/independent/delegate_method_matcher/target_not_defined
 
 module Shoulda
   module Matchers
-    # Matchers for non-Rails-dependent code.
+    # This module provides matchers that are used to test behavior outside of
+    # Rails-specific classes.
     module Independent
     end
   end
diff --git a/lib/shoulda/matchers/warn.rb b/lib/shoulda/matchers/warn.rb
index 95f2abe4..b0f45af3 100644
--- a/lib/shoulda/matchers/warn.rb
+++ b/lib/shoulda/matchers/warn.rb
@@ -1,5 +1,6 @@
 module Shoulda
   module Matchers
+    # @private
     TERMINAL_MAX_WIDTH = 72
 
     # @private