Skip to main content

Engineering Documentation

Overview

Welcome to Rapha's Engineering Documentation. This project is focused on facilitating the sharing of knowledge between technical and non technical roles within Technology and beyond at Rapha.

This was created to solve the problem of scaling technical knowledge dissemination within a growing team of engineers, as sharing progress via emails, google documents, slideshows and git repositories was becoming increasingly impractical.

Reading List

Architecture

Main topics include

  • AWS
    • Services
  • Observability
  • Microservices
  • Technical Sprawl and Stardisation

Design System

  • Guidelines and Decisions

Ethics

  • Code of Conduct
  • Contributing Guide

Frontend

  • Breakpoints
  • Device Matrix
  • Media Queries
  • UI & Content Readiness Checklist and Levels

SAAS

Our third party software as a service providers

  • Sourcegraph

Serverless

  • Monorepo (Usage Guide)

Squads

CMS

  • ADRS
  • Contentful
    • Environments

DAM

  • ADRS

Styleguides

  • JS
  • Markdown
  • Terraform

Templates

  • Commit Messages

Testing

  • The Testing Trophy