- improved documentation of flatten and token