Merge branch 'issue-185' into 'preview'

Added pattern for links in grep-forbidden-words.sh and some description

Closes #185

See merge request !358

doc.zih.tu-dresden.de/README.md

@@ -465,6 +465,8 @@ should be highlighted, etc. Code examples, longer than half screen height should
 **TODO** Guide [Issue #14](#14)
 
 * Capitalize headings, e.g. *Exclusive Reservation of Hardware*
+* Give keywords in link texts, e.g. [Code Blocks](#code-blocks-and-syntax-highlighting) is more
+  descriptive than [this subsection](#code-blocks-and-syntax-highlighting)
 
 ### Spelling and Technical Wording
 

doc.zih.tu-dresden.de/util/check-links.sh

@@ -48,10 +48,12 @@ echo ""
 for f in $files; do
   if [ "${f: -3}" == ".md" ]; then
     # do not check links for deleted files
-    if [ -e $f ]; then
-      echo "Checking links for $f"
-      if ! $mlc -q -p "$f"; then
-        any_fails=true
+    if [ "$f" != "doc.zih.tu-dresden.de/README.md" ]; then
+      if [ -e $f ]; then
+        echo "Checking links for $f"
+        if ! $mlc -q -p "$f"; then
+          any_fails=true
+        fi
       fi
     fi
   fi

doc.zih.tu-dresden.de/util/grep-forbidden-words.sh

@@ -19,6 +19,7 @@ i	\<taurus\>	taurus\.hrsk	/taurus	/TAURUS
 i	\<hrskii\>
 i	hpc[ -]\+da\>
 i	\(alpha\|ml\|haswell\|romeo\|gpu\|smp\|julia\|hpdlf\|scs5\)-\?\(interactive\)\?[^a-z]*partition
+i	\[\s\?\(documentation\|here\|this \(link\|page\|subsection\)\|slides\?\|manpage\)\s\?\]
 i	work[ -]\+space"
 
 # Whitelisted files will be ignored