trace: update the documentation