Thank you for sharing this great piece of information, I just learnt a lot from reading.

My thought on " publishing docs as PDF" what if you could add a link to your docs while working on your remote branch that host the PDF of your docs some where people could actually download.

If it is validated by the reviewer it would help manage the challenge of publishing docs as PDF.