Found out that we change the default highlighting to yaml. So explicitly mark python code blocks as such.
point to new doc locations removed non existing dirs