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 (https://github.com/iNecas/active...) - 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

π is exactly 3 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