Documentation with pleasure

A session at RuPy : Python & Ruby Conference

Saturday 15th October, 2011

11:00am to 12:00pm (WMT)

Many people hate them - those lying bastards hidden behind # sign which use to get obsolete almost immediately - our API documentation. However, is avoiding them really the solution? (ask users of your code) With such a dynamic languages, like Ruby is, it's almost a crime not to try different approach to this.

I will talk about a project I started a while ago ( - a DSL for documentation. I will explain reasons of it's creation and it's objectives. I will also show some implementation details, such as how to describe the DSL with the same DSL :). I'm looking forward to the feedback and discussion.

About the speaker

This person is speaking at this event.
Ivan Nečas

I'm watching you! bio from Twitter

Coverage of this session

Sign in to add slides, notes or videos to this session

Tell your friends!


Time 11:00am12:00pm WMT

Date Sat 15th October 2011

Short URL

Official event site

View the schedule


See something wrong?

Report an issue with this session