We started building our publications repository on GitHub Pages. After six months of building and testing the site, we have now successfully created a subdomain docs.tellusant.com that links to our GithHub Pages in a seamless manner.
This maintains the benefits of being on GitHub Pages (Markdown, LaTex, Mermaid capabilities; static structure not allowing bells and whistles; fast indexing, open access, and more) while consolidating our materials on our main website.