On Jun 21, 2013, at 11:01 PM, Sven Van Caekenberghe <[email protected]> wrote:
> I know you did, but it is as you say: this should be done by someone who > really understands the design. For example: I learned about #resolve: from > comments at the Disk implementation level, not the Public API level where > there are almost no commennts. I got into several loops using wrong methods, > those should have been marked private I would guess. I know this is sad but this is the case with most of the code of colin. I did my best to add comments but guessing is always more error prone and stupid trial and error. Anyway we will improve slowly. I do not understand why writing simple method comments is difficult to do when you write the code of the methods. Stef
