Saturday 15th October, 2011
11:00am to 12:00pm
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.
Sign in to add slides, notes or videos to this session