News for hackers. Stuff that matters.
Re:Gitlab Handbook's HN Page by splittingTimes on Thursday January 20, 2022 @07:52PM (#30017720)
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.

Re:Gitlab Handbook's HN Page by thewoolleyman on Sunday January 23, 2022 @01:04AM (#30043995)
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-...

HTH! -- Chad