#10 deprecated methods documented