improve technical docs overview and made some Registry adapter fixes