The way this repo is structured can be hard to read at times. Have you considered creating a jupyter notebook version of this repo?

Pros

• Better formatting of texts
• Code output can be easily shown
• The illustration images can be added on the same notebook

Overall it would be a nicer learning experience. I have created one example here.