refresh and update to internal docs

harrypm committed Jan 7, 2025

update to current specs

harrypm committed Mar 21, 2024

Part of the overhual updates.

harrypm committed May 28, 2022