Feature/update docs

docs/vale/.vale.ini

@@ -6,14 +6,17 @@ Vocab = geant-jargon, Sphinx
 
 Packages = proselint, Microsoft
 
-[*]
+[*.{md,py}]
+; We only lint .md and .py files
 BasedOnStyles = Vale, proselint, Microsoft
 Microsoft.Headings = NO
 
-[*.html]
-Microsoft.Dashes = NO
-Microsoft.HeadingAcronyms = NO
+TokenIgnores = ({term}`[^\n]+`)
 
-[/docs/source/glossary.md]
-; Ignore acronyms being undefined in the file that defines all acronyms by definition
+[*/glossary.md]
+; Ignore acronyms being undefined in the file that defines all acronyms by definition.
 Microsoft.Acronyms = NO
+
+[formats]
+; Ignore inline comments in source code, as these do not show up in generated documentation.
+py = rst