add adaptor feature, add special attribute handling, update docs