more documentation mostly to Trace