Skip to content

Latest commit

 

History

History
52 lines (44 loc) · 2.17 KB

ARCHITECTURE_STANDARDS.md

File metadata and controls

52 lines (44 loc) · 2.17 KB

Architecture Principles

These principles are an evolution of the GDS Architecture approach

The system exists to serve users

  • Simplicity for users is worth some complexity in the system
  • Users need available and resilient services
  • User experience should degrade gracefully

Be good citizens of the web

  • Don’t break the internet (or peoples bookmarks)
  • All changes should be transparent
  • Breaking changes must be versioned
  • Make use of open standards (as outlined by GDS)

Open source by default

  • Don’t use proprietary formats
  • Open by default - APIs included
  • Avoid vendor lock in where possible, but not at the expense of the operational burden of not using managed services

We are not unique

  • Don’t reinvent the wheel
  • Consume 3rd party APIs for data that isn’t ours to own

Innovate Responsibly™

  • Start small and question scope
  • One step at a time (iteration)
  • Security from the start
  • Eat our own dog food - consume our own APIs

Single responsibilities - the systems and the teams

Design for operability

Repeatable for reliability

  • Choose the right kind of tests for the job
  • Nothing should exist that can’t be rebuilt simply