Brendan LE NY's blog

We have a web application coded with Rails framework and we want it to be compatible with as many instant messaging networks/protocols as possible.

The fist protocol we supported is XMPP/Jabber. This is an open standard, thus librairies are available. We used xmmp4r-simple to develop our interface, and it works fine.

Of Lately we have been churning more and more Ruby on Rails code for our web applications. Its source-code is becoming longer and longer. It was time for us to think about formalizing the documentation process.

After a short search, we found rdoc and it seems to suit our needs. It has good source-analysing basis and interesting features such as diagram generation. The problem came from rdoc youngness which led to two issues :