< Return to Blog

How to create local copy of Rails API doc with YARD

Thanks to Aslam's fantastic blog post on the topic, I decided to try and get the docs via YARD.

First install YARD

gem install yard

The obvious step is to fork the rails source and simply perform yardoc which is an alias to doing yard doc. This will output the nicely YARD-formatted Rails API into the /doc folder.

If you wish to view, say the Rails API via your own local YARD server, simply perform

yard -n --single-db && yard server

Point your browser to http://localhost:8808 to view your Rails API documentation, all nicely YARD-formatted.