Hello Everyone, *TLDR*
Should we adopt a set of standards that Connector I/Os should adhere to? Attached is a first version of a Beam I/O Standards guideline that includes opinionated best practices across important components of a Connector I/O, namely Documentation, Development and Testing. *The Long Version* Apache Beam is a unified open-source programming model for both batch and streaming. It runs on multiple platform runners and integrates with over 50 services using individually developed I/O Connectors <https://beam.apache.org/documentation/io/connectors/>. Given that Apache Beam connectors are written by many different developers and at varying points in time, they vary in syntax style, documentation completeness and testing done. For a new adopter of Apache Beam, that can definitely cause some uncertainty. So should we adopt a set of standards that Connector I/Os should adhere to? Attached is a first version, in Doc format, of a Beam I/O Standards guideline that includes opinionated best practices across important components of a Connector I/O, namely Documentation, Development and Testing. And the aim is to incorporate this into the documentation and to have it referenced as standards for new Connector I/Os (and ideally have existing Connectors upgraded over time). If it looks helpful, the immediate next step is that we can convert it into a .md as a PR into the Beam repo! Thanks and looking forward to feedbacks and discussion, [PUBLIC] Beam I/O Standards <https://docs.google.com/document/d/1BCTpSZDUjK90hYZjcn8aAnPd9vuRfj8YU1j3mpSgRwI/edit?usp=drive_web> Herman Mak | Customer Engineer, Hong Kong, Google Cloud | herman...@google.com | +852-3923-5417 <+852%203923%205417>
