[doc] fix links and titles

Author: HugoStrand

doc/about.rst

@@ -1,18 +1,18 @@
 .. _about:
 
 
-About triqs_soehyb
-==================
+About
+*****
 
 The TRIQS Sum-Of-Exponentials bold HYBridization expansion impurity solver was originally developed by Z. Huang, J. Kaye, and H. U.R. Strand.
 
-We thank N. Wentzell for contributions, support and guidance in using the `TRIQS library<https://github.com/TRIQS/triqs>`_ and its related packages. For the TRIQS application structure we are depending on the `app4triqs <https://github.com/TRIQS/app4triqs>`_ framework.
+We thank N. Wentzell for contributions, support and guidance in using the `TRIQS library <https://github.com/TRIQS/triqs>`_ and its related packages. For the TRIQS application structure we are depending on the `app4triqs <https://github.com/TRIQS/app4triqs>`_ framework.
 
 
 License
 =======
 
-The TPRF application is published under the `GNU General Public License, version 3.<http://www.gnu.org/licenses/gpl.html>`_
+The TPRF application is published under the `GNU General Public License, version 3. <http://www.gnu.org/licenses/gpl.html>`_
 
 Note that it implies that applications using TPRF must also be GPL.
 
@@ -28,9 +28,9 @@ Citation
 
 We kindly ask you to cite the following method papers when using triqs_soehyb in your work
 
-.. [@dlrhyb] `J. Kaye, Z. Huang, H. U.R. Strand, D. Golež, Phys. Rev. X 14, 031034 (2024) <https://doi.org/10.1103/PhysRevX.14.031034>`_
-.. [@soehyb] `Z. Huang, D. Golež, H. U.R. Strand, J. Kaye, arXiv:2503.19727 (2025) <https://doi.org/10.48550/arXiv.2503.19727>`_
-.. [@cppdlr] `J. Kaye, H. U.R. Strand, N. Wentzell, J. Open Source Softw., 9(100), 6297, (2024) <https://doi.org/10.21105/joss.06297>`_
-.. [@dlr] `J. Kaye, K. Chen, O. Parcollet, Phys. Rev. B 105, 235115 (2021) <https://doi.org/10.1103/PhysRevB.105.235115>`_
+.. [#dlrhyb] `J. Kaye, Z. Huang, H. U.R. Strand, D. Golež, Phys. Rev. X 14, 031034 (2024) <https://doi.org/10.1103/PhysRevX.14.031034>`_
+.. [#soehyb] `Z. Huang, D. Golež, H. U.R. Strand, J. Kaye, arXiv:2503.19727 (2025) <https://doi.org/10.48550/arXiv.2503.19727>`_
+.. [#cppdlr] `J. Kaye, H. U.R. Strand, N. Wentzell, J. Open Source Softw., 9(100), 6297, (2024) <https://doi.org/10.21105/joss.06297>`_
+.. [#dlr] `J. Kaye, K. Chen, O. Parcollet, Phys. Rev. B 105, 235115 (2021) <https://doi.org/10.1103/PhysRevB.105.235115>`_
 
-Note that this application uses the TRIQS library please also see its `citation page.<https://triqs.github.io/triqs/latest/about.html#citation>`_
+Note that this application uses the TRIQS library please also see its `citation page. <https://triqs.github.io/triqs/latest/about.html#citation>`_

doc/documentation.rst

@@ -4,11 +4,6 @@ Documentation
 *************
 
 
-.. math::
-
-   (a + b)^2  &=  (a + b)(a + b) \\
-              &=  a^2 + 2ab + b^2
-
 Tutorials
 ---------
 
@@ -19,15 +14,16 @@ Tutorials
 
 
 C++ reference manual
-====================
+--------------------
 
 .. toctree::
    :maxdepth: 5
 
    cpp2rst_generated/contents
 
+
 Python reference manual
-=======================
+-----------------------
 
 .. autosummary::
    :toctree: _autosummary