update docs to include logging