add notes about shell tracing