3 ms·

Hi John, A bit off topic, but if I would like to introduce such a handbook on my team as well, what technology does it use? It looks and feels so much fresher,

Hi John, A bit off topic, but if I would like to introduce such a handbook on my team as well, what technology does it use? It looks and feels so much fresher, clean and responsive than a simple wiki. I see it is markdown files with some CSS, but what engine do you use to build and render the handbook. Is there a repo that holds the template to set up such a handbook? Cheers and congrats. Always admired how you kept all your employees engaged with the handbook to not have it deteriorate, but thrive.

thewoolleyman 5y ago
TL;DR: It is a JAMStack-style static site, which we publish with the Middleman static site editor. However, there's a lot more to it than that, and it's always actively evolving. There's not currently a page which summarizes the architecture, but there are multiple pages and docs which are focused on processes around editing and maintaining the site. Here is a link which is a good starting point to see what's under the covers and how we use it: https://about.gitlab.com/handbook/git-page-update/#11-start-contributing https://about.gitlab.com/handbook/git-page-update/#11-start-... HTH! -- Chad