G-Starlink Handbook

This is the single source of truth for how G-Starlink operates. Everything — from how we handle B2B orders, to our product data model, to how the three-location team collaborates — lives here.

We follow a handbook-first approach inspired by GitLab: if something has been asked twice, it belongs in this handbook. If a decision was made, it belongs in this handbook. The chat thread, email, or meeting is the process; the handbook is the outcome.

How this site is organized

The handbook is divided into seven modules. Each has its own maintainer and rhythm.

Two audiences, one source

This handbook is built twice from the same source code:

• Internal build (handbook.gstarlink.com) — everything. Protected by Cloudflare Access.
• Public build (docs.gstarlink.com) — only pages marked public: true in their frontmatter. No authentication, indexable by Google.

Content authors don’t choose which site a page goes to — they set public: true or public: false in the frontmatter and the build pipeline sorts it out.

Three rules for everyone

1. If you were asked a question twice, write the answer here. Next time, send the link.
2. Write decisions, not just chat. After any Slack thread that concludes with “OK, let’s do X,” someone writes X down here.
3. Edit freely. This is a working document, not a sacred text. If something is wrong, fix it.

Can’t find what you need?

• Use the search box at the top
• Check the sidebar for the module most relevant to your question
• Still nothing? Ask in #general on Slack and whoever answers must also write the answer here before closing the conversation.