Documentation is not always up to date for RubyGems which are heavily involved in application development. While documentation is mostly available for the popular gems, trying lesser-known libraries and gems can mean taking your chances.
The developer suffers in this case, as they have to repeatedly check for the required functionality and waste development time.