YARD Sale: Documenting Clearance

We’ve previously stated our commitment to rdoc.info as the official documentation home of our open source projects.

Add the documentation for Clearance to that list.

Clearance documentation

Why

Blog posts and wikis are good for tutorials, not for API documentation.

YARD is awesome. Take five minutes to scan the Getting Started page.

World

rdoc.info is open source. I’m happy to outsource documentation generation and serving like any other service such as source code hosting or error notification tracking.

Positive side effect: visibility

The process of documenting with YARD made me think harder about public/private visibility. I was surprised that documentation could be a design tool.

Looking at the public API, I noticed how many methods are required to handle the remember me as a “feature”.

If we go to a GitHub/Tumblr model, the API will be simpler and the implementation cleaner.

Pair with one of our expert developers to level up your skills with Coaching by thoughtbot. Save time learning best practices and techniques for reducing technical debt in Ember, Ruby, Haskell, and Go in 1-on-1 sessions tailored to your goals.