Comment by lacunary

anything exposed for others to depend on becomes part of the actual boundary. if it might break someone's system when you change it's part of your API.

the problem is not in documenting the subset of a giant surface you intend to support; the problem is having a giant surface!