add debug documentation