updates to shortcomings and principles