Define the process for additions to the API

[jkwatson]

We should have a well-defined process for how to add things to our public APIs.

Some questions:

• Do we require any API changes to start in an incubator module?
• At what point do we require spec changes/clarifications before we will accept new APIs?
• Do we require all maintainers to approve before merging?

[harshita19244]

Hey, could you assign me this issue, I am interested to work on it.

[harshita19244]

In order to make changes, should I send a pr to the README itself?

[jkwatson]

In order to make changes, should I send a pr to the README itself?

Probably to the Contributing.md rather than the readme.

[harshita19244]

#3082
I am unable to link the PR to the issue currently. Kindly check, I have made a change in the CONTRIBUTING.md that presently answers the third question.

[jkwatson]

#3082
I am unable to link the PR to the issue currently. Kindly check, I have made a change in the CONTRIBUTING.md that presently answers the third question.

I think you are misunderstanding the goal of this issue. This is specifically about additions to our API surface, not changes to the code in general. API changes must be very carefully scrutinized because we will support them forever.