Inconsistent documentation on map remove_columns
MEMBER
Thanks for reporting, @zhaowei-wang-nlp.

You are right, the documentation is confusing on the behavior of `remove_columns`. We should better explain it. 
2022-10-24T06:40:27Z
https://github.com/huggingface/datasets/issues/5144#issuecomment-1288493136
https://api.github.com/repos/huggingface/datasets/issues/5144
IC_kwDODunzps5MzNhQ
https://api.github.com/repos/huggingface/datasets/issues/comments/1288493136/reactions
2022-10-24T06:40:27Z
https://api.github.com/repos/huggingface/datasets/issues/comments/1288493136
https://avatars.githubusercontent.com/u/8515462?v=4
https://api.github.com/users/albertvillanova/events{/privacy}
https://api.github.com/users/albertvillanova/followers
https://api.github.com/users/albertvillanova/following{/other_user}
https://api.github.com/users/albertvillanova/gists{/gist_id}
https://github.com/albertvillanova
albertvillanova
MDQ6VXNlcjg1MTU0NjI=
https://api.github.com/users/albertvillanova/orgs
https://api.github.com/users/albertvillanova/received_events
https://api.github.com/users/albertvillanova/repos
https://api.github.com/users/albertvillanova/starred{/owner}{/repo}
https://api.github.com/users/albertvillanova/subscriptions
User
https://api.github.com/users/albertvillanova
public
COLLABORATOR
This is a duplicate of https://github.com/huggingface/datasets/issues/2343.
2022-10-24T11:32:43Z
https://github.com/huggingface/datasets/issues/5144#issuecomment-1288900070
https://api.github.com/repos/huggingface/datasets/issues/5144
IC_kwDODunzps5M0w3m
https://api.github.com/repos/huggingface/datasets/issues/comments/1288900070/reactions
2022-10-24T11:32:43Z
https://api.github.com/repos/huggingface/datasets/issues/comments/1288900070
https://avatars.githubusercontent.com/u/47462742?v=4
https://api.github.com/users/mariosasko/events{/privacy}
https://api.github.com/users/mariosasko/followers
https://api.github.com/users/mariosasko/following{/other_user}
https://api.github.com/users/mariosasko/gists{/gist_id}
https://github.com/mariosasko
mariosasko
MDQ6VXNlcjQ3NDYyNzQy
https://api.github.com/users/mariosasko/orgs
https://api.github.com/users/mariosasko/received_events
https://api.github.com/users/mariosasko/repos
https://api.github.com/users/mariosasko/starred{/owner}{/repo}
https://api.github.com/users/mariosasko/subscriptions
User
https://api.github.com/users/mariosasko
public
MEMBER
I'm closing this issue because as @mariosasko pointed out, it is a duplicate of:
- #2343
2022-11-15T14:15:10Z
https://github.com/huggingface/datasets/issues/5144#issuecomment-1315370088
https://api.github.com/repos/huggingface/datasets/issues/5144
IC_kwDODunzps5OZvRo
https://api.github.com/repos/huggingface/datasets/issues/comments/1315370088/reactions
2022-11-15T14:15:10Z
https://api.github.com/repos/huggingface/datasets/issues/comments/1315370088
https://avatars.githubusercontent.com/u/8515462?v=4
https://api.github.com/users/albertvillanova/events{/privacy}
https://api.github.com/users/albertvillanova/followers
https://api.github.com/users/albertvillanova/following{/other_user}
https://api.github.com/users/albertvillanova/gists{/gist_id}
https://github.com/albertvillanova
albertvillanova
MDQ6VXNlcjg1MTU0NjI=
https://api.github.com/users/albertvillanova/orgs
https://api.github.com/users/albertvillanova/received_events
https://api.github.com/users/albertvillanova/repos
https://api.github.com/users/albertvillanova/starred{/owner}{/repo}
https://api.github.com/users/albertvillanova/subscriptions
User
https://api.github.com/users/albertvillanova
public
### Describe the bug

The page [process](https://huggingface.co/docs/datasets/process) says this about the parameter `remove_columns` of the function `map`:
When you remove a column, it is only removed after the example has been provided to the mapped function.

So it seems that the `remove_columns` parameter removes after the mapped functions.

However, another page, [the documentation of the function map](https://huggingface.co/docs/datasets/v2.6.1/en/package_reference/main_classes#datasets.Dataset.map.remove_columns) says:
Columns will be removed before updating the examples with the output of `function`, i.e. if `function` is adding columns with names in remove_columns, these columns will be kept.

So one page says "after the mapped function" and another says "before the mapped function."
Is there something wrong?


### Steps to reproduce the bug

Not about code.

### Expected behavior

consistent about the descriptions of the behavior of the parameter `remove_columns` in the function `map`.

### Environment info

datasets V2.6.0