How exactly does the GithHb integration notify Transifex of updated files in a repo?

I would like to know precisely how Github notifies Transifex when files are changed in the repository. The documentation says it happens “automatically”, which is a bit vague:

Whenever your config file is updated in your GitHub repository or from within the integration, Transifex is notified, and a sync process between the two systems is triggered automatically.

But I assume it means that it creates a webhook.

(It’s also a bit confusing: “Whenever new files are added to the configuration file…” - what does that mean?)

The initial sync worked fine, but new commits to the repository don’t trigger anything. There are no errors - just silence.

If it was supposed to create a webhook in the repository, it has not - should it? Or does it have some other way of notifying Transifex?

I have tried removing and reinstalling/configuring the GitHub integration from scratch.

Hello,

Thank you for your interest in Transifex. So you are right. The installation creates a webhook for back and forth syncs. So this is how system knows when to sync the files.

It’s also a bit confusing: “Whenever new files are added to the configuration file…” - what does that mean?

When you create the integration you ad a yml file that handles which files exactly (or directories depending on what you have added there) you are syncing . So whenever you want to add a new resource to the sync for Transifex to watch and sync, then we pick it up via the yml file (you need to add it manually to that file for the automation to know to sync it).

The changes you make to source files are being picked up and they sync the strings - new content to the created files in Transifex. you will not see on github side any notification. You will see it on Transifex side on the integration sync dashboard.

Hope this clears the field.

Thanks @chrisb that is helpful. I think it would be worth adding it to GitHub: Installation and configuration | Transifex Help Center that in the Git hub repo > Settings > Webhooks you will not actually see a Transifex webhook listed..

I think another thing that could be made explicit in the documentation is that the GitHub Integration will not pick up changes made to a translation’s .po file (if for example someone edits that locally and pushes back to GitHub), but only in the source language’s .po file.