It's hard to argue with the value of good documentation and I do agree that this is an area where more work is needed. The problem is that things keep changing so it's something that needs to be kept up to date.
I think the Vector class is ok but I will make a note to add some documentation to the Region class. But really I would like to add some higher level documentation explaining why things are the way they are, and to address some of the usage questions which come up quite frequently.
Well, now we have a bug for it, so I'll leave this open until it's done...
|