clearer advanced usage docs