Various updates

usage, under the hood, and the to-do