The very first paragraph in the DateCalc description ends with:

I acknowledge I was wrong about that.

However, a long-time, but infrequent user of your powerful module, I always have to look up how to do things, and always find myself scrolling up and down the page trying to find the information I need.

I do understand how difficult it is to write good documentation, and I do not have any simple suggestions for improvement. I note also that you have made considerable changes in that regard in recent builds. I will contact you by email.