diff --git a/README.md b/README.md
index b08fbe3..7b1bfc8 100644
--- a/README.md
+++ b/README.md
@@ -11,8 +11,8 @@ A collection of Python classes and functions in Sage to deal with Hodge diamonds
 
 You can read its documentation as
 
-* [a webpage](https://pbelmans.ncag.info/hodge-diamond-cutter)
-* [a pdf](https://pbelmans.ncag.info/hodge-diamond-cutter/hodgediamondcutter.pdf)
+* [a webpage](https://cutter.ncag.info)
+* [a pdf](https://cutter.ncag.info/documentation.pdf)
 
 
 ## Getting started
diff --git a/diamond/diamond.py b/diamond/diamond.py
index 99143b6..43d8012 100644
--- a/diamond/diamond.py
+++ b/diamond/diamond.py
@@ -2,6 +2,9 @@
 A tool to work with Hodge diamonds, comes with many varieties and constructions
 built into it.
 
+* `repository <https://github.com/pbelmans/hodge-diamond-cutter>`_
+* `documentation <https://cutter.ncag.info>`_
+
 Hodge diamonds encode the Hodge numbers of a variety, and provide interesting
 information about its structure. They provide a numerical incarnation of many
 operations one can perform in algebraic geometry, such as blowups, projective
@@ -105,11 +108,12 @@
     sage: print(S == K3())
     True
 
-Check out the [documentation](https://pbelmans.ncag.info/hodge-diamond-cutter)
+Check out the `documentation <https://cutter.ncag.info>`_
 for all the available functionality.
 
 If you use the software in your work, please cite it as explained on
-[Zenodo](https://doi.org/10.5281/zenodo.3893509).
+`Zenodo <https://doi.org/10.5281/zenodo.3893509>`_, or in
+`the README file <https://github.com/pbelmans/hodge-diamond-cutter?tab=readme-ov-file#how-to-cite>`_.
 
 AUTHORS: