clarifies some docs