Explicitly spelling out the lack of stability for the C++ API in the Developer Policy?

I agree that a documented C++ api stability policy would be valuable. Since the policy seems to be “the API is not stable”, it would be helpful to have it written down for when people push back on changes because they would cause API breakages.

I would think the “Introducing new things into the API” section would say something to the effect of “features may be added with impunity, subject to code review”. Though since new features added to an API without removing other things does not represent any sort of breakage, maybe it doesn’t bear mentioning in a section about API stability.


Christopher Tetreault