Skip to content

Engineering resources

Start with the fundamentals

A guide to finding your way around the handbook, reading examples, and keeping the material useful as our work evolves.

Find the task in front of you

This handbook is organized around the work engineers do. Browse a section when you need context, or use search to find a specific practice. Each guide should stand on its own and link to deeper material where it helps.

A useful rule

Use the shortest guide that gives enough context to make the next decision.

Read code examples in context

Examples show one way to apply a practice. Read the surrounding explanation for its trade-offs, then adapt the code to your service or feature.

// Keep the important decision explicit.
const result = await loadDocument(id);

if (!result) return { status: 'not-found' };

return { status: 'ok', result };

Use diagrams to orient the reader

A diagram should make a relationship or sequence easier to see. Give it useful labels and explain the important decision in the surrounding text.

Update the handbook near the work

If a guide is unclear, out of date, or missing a useful example, update it where the work happens. Small, specific changes keep instructions close to the systems they describe.