Isn't it better to do inline code comments, e.g. JavaDoc?