Document flattened_from_extras also and remove some obsolete comments