diff --git a/doc/Doxyfile b/doc/Doxyfile
index b53045d0a..3affa82e3 100644
--- a/doc/Doxyfile
+++ b/doc/Doxyfile
@@ -1602,4 +1602,7 @@ DOT_CLEANUP            = YES
 HTML_EXTRA_STYLESHEET = .github/doxygen-awesome-css/doxygen-awesome.css
 
 INPUT += doc/README.md
+INPUT += doc/modeling/theory.md
+INPUT += doc/modeling/implementation.md
+
 USE_MDFILE_AS_MAINPAGE = doc/README.md
diff --git a/doc/README.md b/doc/README.md
index a991a5368..3962dfbfe 100644
--- a/doc/README.md
+++ b/doc/README.md
@@ -14,8 +14,8 @@ It also presents some examples of use and lists the current limitations.
 
 
 ## 2. Documentation cover:
-- [Modeling theory](modeling/theory.md)
-- [Modeling scene implementation](modeling/implementation.md)
+- [Modeling theory](https://github.com/sofa-framework/BeamAdapter/blob/master/doc/modeling/theory.md)
+- [Modeling scene implementation](https://github.com/sofa-framework/BeamAdapter/blob/master/doc/modeling/implementation.md)
 
 
 ## 3. Technical roadmap