Tonight marks the return of the Toronto Ruby on Rails Project Night. For those attending, remember that tonight’s event will be held at the Rich Media Institute, located at 156 August Avenue, Toronto. We’ll begin at 6pm, so please arrive promptly and be sure to bring your presentation ideas for future project nights!
Here’s a quick update from our presenter Paul Doerwald:
“Programmers generally hate writing documentation. That’s because most documentation is kept separate from the code and becomes hard to keep up-to-date. Besides violating the DRY principle… it can lead to misleading documentation, which is generally worse than none at all.” [Subramaniam/Hunt ’06]. Why do developers hate writing documentation, and why do stakeholders and managers keep requiring it? Is there agile documentation beyond inline API documentation (JavaDoc, RDoc, etc.) and comments in the code? What parts of a project deserve separate-from-code documentation? How do we identify them, capture them, and keep them relevant?
Tonight’s Toronto Ruby on Rails Project Night presentation discusses the problem of documentation, explores some key aspects to consider when writing effective documentation, and dreams of a future of testable, executable documentation, where non-code knowledge could be integrated into your code.“
We will also be joined by James Robertson, Cincom Smalltalk Product Evangelist, who is on a ‘Canadian Tour’ looking at Seaside and WebVelocity:
WebVelocity is a new Smalltalk Development Environment that is oriented around Seaside for Web Development and Glorp for Object/Relatonal Mapping. Come and see how WebVelocity re-targets the Smalltalk development experience into the Web Browser and simplifies the challenge of learning a new environment for newcomers. We’ll even build an entire application using Active Record and Scaffolding during the presentation, with minimal programming. If you’re a fan of Ruby on Rails, you need to come out and see this presentation!
Thanks to everyone who has already RSVP’d – we have a few spots left for tonight’s event, please email me at firstname.lastname@example.org right away if you are interested in attending!