[ChrisMarshallNY]

I've found that headerdoc-style documentation works very well.

It does require a teensy bit of extra discipline and vigilance, on my part, but it is usually supported by many tools.

If I do it that way, it's automatically displayed in mouseovers in Xcode, and can be compiled into organized sites, by Jazzy.

I write about my methodology, here: https://littlegreenviper.com/miscellany/leaving-a-legacy/