docs: add extensive code comments

chore: clean up code

md used for the DokuWiki Plugin page (https://www.dokuwiki.org/plugin:pagecss)