[GitHub] [beam] aromanenko-dev commented on pull request #22409: Exclude javadocs for experimental SparkStructuredStreamingRunner

[GitBox <gi...@apache.org>]

aromanenko-dev commented on PR #22409:
URL: https://github.com/apache/beam/pull/22409#issuecomment-1194079110

   I'd agree to not have these Javadocs if they have not been published yet. For now, until we have these classes available for users (even if we are 99% sure that they mostly not used), I'd prefer to keep them for a sake of integrality since Beam  still provide them.
   
   > IMHO, with almost absolute certainty, you can count on the fact that every single user looking for Spark runner related Javadocs isn't looking for the ones of the SparkStructuredStreamingRunner. 
   
   Agree but it also means that they very likely won't be confused or mislead with that =) To annotate them `@Experimental`, as I proposed before, will make it easier to change the naming or other API changes in the future.


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

To unsubscribe, e-mail: github-unsubscribe@beam.apache.org

For queries about this service, please contact Infrastructure at:
users@infra.apache.org