trying to tie down the framework so everything plays well together