How can I submit a tap to the hub?
# singer-tap-development
a
How can I submit a tap to the hub?
a
Hi, @adam_roderick. I think we are still working to improve the how-to docs in this regard. For now, you can use this MR as a sample. The process is to send an MR with a yaml file named like
_data/taps/<sourcename>.yml
combined with a logo file (if not already existing):
assets/logos/taps/<sourcename>.png
Does this help?
a
yep, makes sense
Different question, have you liked the fork/MR approach to having others contribute to this? I'm working on a different concept and want community contributions--any advice to share?
a
A great question. 馃檪 We are still learning ourselves, I think. In future, we may consider a templated-issue approach - meaning, we'd create a link to open an issue with prompts that the submitter can complete. The tradeoff though, is that in exchange for reducing the barrier of entry for submissions and giving a more guided experience, then we (Meltano) still have to take the extra step of guiding the contributor through the yml creation process or to create it ourselves.
Also - in terms of the process here, I think for the best user experience for meltano folks, we'd like to also appreciate if you can include a yaml file that matches to
_data/meltano/extractors/<sourcename>.yml
as shown here: _data/meltano/extractors/bigquery.yml 路 main 路 Meltano / MeltanoHub 路 GitLab
It's mostly the same info, except including
capabilities
declaration as well. (If this is an SDK tap, we can likely detect some/all of this. In future, we plan to have the SDK auto-generate much of it's yaml declarations.)
Logging an action item so we can more proactively message the process here: Create a guide for adding new taps/targets to the hub (#110) 路 Issues 路 Meltano / MeltanoHub 路 GitLab
a
Thanks for this!
@aaronsteers @taylor here is the MR to add tap-clickcast to the meltano hub