Fix YARD documentation warnings (#21)

Additionally:
- Use https where possible
- Remove 404 links (`awesome_bot`)
- Fix typos (`codespell`)

Author: Copilot

CHANGELOG.md

@@ -2,8 +2,15 @@
 
 All notable changes to this project will be documented in this file.
 
-The format is based on [Keep a Changelog](http://keepachangelog.com/) and this
-project adheres to [Semantic Versioning](http://semver.org/)
+The format is based on [Keep a Changelog](https://keepachangelog.com/) and this
+project adheres to [Semantic Versioning](https://semver.org/)
+
+## Unreleased
+
+### Fixed
+* Fix YARD documentation warnings:
+  - Remove curly braces from `@see` tags (causes rendering issues)
+  - Use fully-qualified constant names for `ACL#find_by_role` references (`Eaco::ACL#find_by_role`)
 
 ## 1.1.1 - 2017-03-08
 

features/support/env.rb

@@ -13,15 +13,15 @@
 
 ##
 # Create a whole new world.
-# @see {World}
+# @see World
 # @!method World
 World do
   Eaco::Cucumber::World.new
 end
 
 ##
 # Recreate the schema before each feature, to start fresh.
-# @see {ActiveRecord.define_schema!}
+# @see ActiveRecord.define_schema!
 # @!method Before
 Before do
   Eaco::Cucumber::ActiveRecord.define_schema!

lib/eaco.rb

@@ -60,7 +60,7 @@ def self.parse_rules!(rules)
   end
 
   ##
-  # Evaluates the given authorization rules +source+, orignally found on
+  # Evaluates the given authorization rules +source+, originally found on
   # +path+.
   #
   # @param source [String] {DSL} source code

lib/eaco/adapters.rb

@@ -1,6 +1,6 @@
 module Eaco
 
-  # Persistance adapters for ACL objects and authorized collections extractor
+  # Persistence adapters for ACL objects and authorized collections extractor
   # strategies.
   #
   # @see ActiveRecord

lib/eaco/adapters/active_record.rb

@@ -21,7 +21,7 @@ def self.strategies
       end
 
       ##
-      # Checks whether the model's data structure fits the ACL persistance
+      # Checks whether the model's data structure fits the ACL persistence
       # requirements.
       #
       # @param base [Class] your application's model

lib/eaco/adapters/active_record/compatibility/v40.rb

@@ -10,7 +10,7 @@ module V40
           ##
           #
           # Sets up the OID Type Map, reloads it, hacks native database types,
-          # and makes jsonb mimick itself as a json - for the rest of the AR
+          # and makes jsonb mimic itself as a json - for the rest of the AR
           # machinery to work intact.
           #
           # @param base [Class] the +ActiveRecord+ model to mangle

lib/eaco/adapters/active_record/compatibility/v51.rb

@@ -11,7 +11,7 @@ class Compatibility
         #
         # @see Scoped
         #
-        # Sanitize has dissapeared in favour of quote.
+        # Sanitize has disappeared in favour of quote.
         #
         # @see Sanitized
         #

lib/eaco/adapters/active_record/compatibility/v52.rb

@@ -11,7 +11,7 @@ class Compatibility
         #
         # @see Scoped
         #
-        # Sanitize has dissapeared in favour of quote.
+        # Sanitize has disappeared in favour of quote.
         #
         # @see Sanitized
         #

lib/eaco/adapters/active_record/compatibility/v60.rb

@@ -11,7 +11,7 @@ class Compatibility
         #
         # @see Scoped
         #
-        # Sanitize has dissapeared in favour of quote.
+        # Sanitize has disappeared in favour of quote.
         #
         # @see Sanitized
         #

lib/eaco/adapters/active_record/compatibility/v61.rb

@@ -11,7 +11,7 @@ class Compatibility
         #
         # @see Scoped
         #
-        # Sanitize has dissapeared in favour of quote.
+        # Sanitize has disappeared in favour of quote.
         #
         # @see Sanitized
         #