[maintenance] pointers + documentation