Sounds like a good idea. I don't think it will work for all capabilities
(e.g. some of them such as "exactly once" apply to all of the API surface),
but useful for the ones that we can capture.

On Thu, Oct 4, 2018 at 2:43 AM Etienne Chauchot <[email protected]>
wrote:

> Hi guys,
> As part of our user experience improvement to attract new Beam users, I
> would like to suggest something:
>
> Today we only have the capability matrix to inform users about features
> support among runners. But, they might discover only when the pipeline
> runs, when they receive an exception, that a given feature is not supported
> by the targeted runner.
> I would like to suggest to translate the capability matrix into the API
> with annotations for example, so that, while coding, the user could know
> that, for now, a given feature is not supported on the runner he targets.
>
> I know that the runner is only specified at pipeline runtime, and that
> adding code would be a leak of runner implementation and against
> portability. So it could be just informative annotations like @Experimental
> for example with no annotation processor.
>
> WDYT?
>
> Etienne
>

Reply via email to