diff --git a/doc/.vale.ini b/doc/.vale.ini
index b10919f63..20177c586 100644
--- a/doc/.vale.ini
+++ b/doc/.vale.ini
@@ -28,4 +28,6 @@ Vocab = ANSYS
 BasedOnStyles = Vale, Google
 
 # Removing Google-specific rule - Not applicable under some circumstances
-Google.Colons = NO
\ No newline at end of file
+Google.Colons = NO
+
+TokenIgnores = ((:py)?:(func|class|meth|attr|py):`(?:.|\n)*?`)|(<.*>)|(.. code::.*\n|    .*)
diff --git a/doc/source/index.rst b/doc/source/index.rst
index 83a59d6b7..22e364adc 100644
--- a/doc/source/index.rst
+++ b/doc/source/index.rst
@@ -78,7 +78,8 @@ Limitations
   preprocessed with ACP and if the corresponding lay-up definition file is passed to the :class:`.CompositeModel` class.
 
   - The evaluation of the failure criteria for sandwich
-    (:class:`FaceSheetWrinklingCriterion <.failure_criteria.FaceSheetWrinklingCriterion>`, :class:`ShearCrimpingCriterion <.failure_criteria.ShearCrimpingCriterion>`)
+    (:class:`FaceSheetWrinklingCriterion <.failure_criteria.FaceSheetWrinklingCriterion>`,
+    :class:`ShearCrimpingCriterion <.failure_criteria.ShearCrimpingCriterion>`)
     for solid elements. Layered shell elements are always supported.
 
   - The computation of interlaminar normal stresses (s3) for layered shell elements.