notes about shortcomings added