Completely agree. Way better than than the crappy documentation you often get from vendors like Microchip.

with Microchip you get more than crappy docs. You get plenty of bugs in the hardware. After spending weeks finding one you report it and they say "Yeah, we know.". I still use them. Once you patch and work around all the bugs you can get somewhere nice.

Some examples on pic24fj256gb108: The onboard BOR circuit cannot be trusted. One of the GPIO is listed in the data sheet as being a real GPIO, but the driver is missing because it was used for a USB feature.