On Wed, Feb 22, 2017 at 5:35 PM, Chamikara Jayalath <chamik...@apache.org> wrote: > > I think, this point applies to Python SDK as well (though as you mentioned, > API hiding in Python is a mere convention (prefix with underscore) not > enforced. We already have mechanism for marking APIs as deprecated which > might be useful here: > https://github.com/apache/beam/blob/master/sdks/python/ > apache_beam/utils/annotations.py > > - Cham >
Perhaps an explicit @public annotation would fit. I could imagine easily generating a spec to check against from such annotations, though tooling is secondary to documentation. Kenn