diff --git a/doc/faq.rst b/doc/faq.rst
index 13e1c007..efc41ad1 100644
--- a/doc/faq.rst
+++ b/doc/faq.rst
@@ -20,7 +20,7 @@ convenience, for the following reasons:
 How to add a configure step to a jbuilder project?
 ==================================================
 
-[example/sample-projects/with-configure-step](example/sample-projects/with-configure-step)
+`example/sample-projects/with-configure-step https://github.com/ocaml/dune/tree/master/example/sample-projects/with-configure-step`__
 shows one way to do it which preserves composability; i.e. it doesn't require
 manually running `./configure` script when working on multiple projects at the
 same time.
@@ -28,7 +28,7 @@ same time.
 Can I use topkg with jbuilder?
 ==============================
 
-Yes, have a look at the [topkg-jbuilder][topkg-jbuilder] project for
+Yes, have a look at the `topkg-jbuilder https://github.com/samoht/topkg-jbuilder`__ project for
 more details.
 
 here can I find some examples of projects using Jbuilder?