diff --git a/docs/dev/how-to-develop-using-docker.md b/docs/dev/how-to-develop-using-docker.md
index 90690411fb237..7afce6147fe71 100644
--- a/docs/dev/how-to-develop-using-docker.md
+++ b/docs/dev/how-to-develop-using-docker.md
@@ -166,7 +166,7 @@ db.products.find({_id: "5053990155354"})
 db.products.deleteOne({_id: "5053990155354"})
 ```
 
-See the [`mongo` shell docs](https://docs.mongodb.com/manual/reference/mongo-shell/) for more commands.
+See the [`mongo` shell docs](https://www.mongodb.com/products/shell) for more commands.
 
 ## Adding environment variables
 
diff --git a/docs/dev/how-to-use-gitpod.md b/docs/dev/how-to-use-gitpod.md
index 604b45f95ee96..b193803e332b5 100644
--- a/docs/dev/how-to-use-gitpod.md
+++ b/docs/dev/how-to-use-gitpod.md
@@ -27,7 +27,7 @@ On the Gitpod side, you can also update what Gitpod is allowed to do with your G
 
 ## Get Started
 
-[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/https://github.com/openfoodfacts/openfoodfacts-server/)
+[![Open in Gitpod](https://gitpod.io/button/open-in-gitpod.svg)](https://gitpod.io/#https://github.com/openfoodfacts/openfoodfacts-server/)
 > Gitpod will automatically clone and open the repository for you in VSCode by default. It will also automatically build
 > the project for you on opening and comes with Docker and other tools pre-installed making it one of the fastest ways
 > to spin up an environment for `openfoodfacts-server`.