Deprecation of the git:// protocol on GitHub

2022-03-01T00:00:00Z

Last year, GitHub announced the deprecation of the unsecured Git protocol due to security reasons. This change will be made permanent on March 15, 2022.

At Read the Docs we found around 900 projects using a Git protocol URL (git://github.com/user/project) to clone their projects. To save time for our users, we have migrated those to use the HTTPS cloning URL instead (https://github.com/user/project).

But there are other places where projects may be using a Git protocol URL, like in submodules or dependencies. You’ll need to migrate those to use a supported protocol in order for your builds to keep working after March 15, 2022. In most cases, this means changing URLs that start with git:// to start with https:// instead. If you have doubts, please check the documentation of the tools you are using, for example:

Note that this applies only to repositories hosted on GitHub, repositories using providers that support the Git protocol won’t be affected.

Read the Docs tries to keep users informed about deprecations and breaking changes that may impact projects. To receive future updates like this, subscribe to our newsletter.

Incoming Webhook Deprecations

2019-01-21T00:00:00Z

In the coming weeks and months, Read the Docs will be moving some projects away from our legacy incoming webhooks, towards our per-project webhook integrations.

Our legacy incoming webhooks were our first attempt at allowing providers like GitHub to automatically trigger builds on for projects on Read the Docs. These webhooks lacked a number of security features, and so, about two years ago, we replaced these with per-project webhook integrations instead. We added a number of features to per-project webhook integrations at the time, and we stopped new projects from using the old incoming webhooks.

It’s possible that your project is still using these deprecated incoming webhooks if your project was configured on Read the Docs more than two years ago. If your project does not have an webhook integrations under the Integrations section of your project’s admin dashboard, you might be using these legacy incoming webhooks.

In order to continue building automatically, projects should reconfigure their repository to use a new project webhook integration instead. For more information, see our docs on Integration Creation.

There are two important dates to note here:

January 31st, 2019

This is the date that GitHub will stop sending notifications through their GitHub Services. Your project might be relying on GitHub Services if your GitHub repository is using the ReadTheDocs GitHub Service and does not have another webhook to Read the Docs configured.

April 1st, 2019

After this date, Read the Docs will stop accepting incoming webhook notifications for the remaining legacy incoming webhooks. You might be using one of these incoming webhooks if your repository has a webhook pointing to any of the following URLs:

We will be sending periodic notifications over the next few weeks to the owners of any projects that are still configured to use these deprecated incoming webhooks.

Read the Docs Blog - Posts tagged deprecation

Deprecation of the git:// protocol on GitHub

Incoming Webhook Deprecations