critical readme update - needs urgent improvement