Architecture Decision Records

This directory collects Architecture Decision Records for the Wikibase REST API.

Current ADRs include:

• 0) Develop the Wikibase REST API inside Wikibase.git
• 1) Follow the Hexagonal Architecture
• 2) Don't use serialized entities in response objects (superseded by ADR 9)
• 3) Fetch revision metadata and entity data separately
• 4) Use PropertyDataTypeLookup in SnakSerializer (superseded by ADR 9)
• 5) Use the JSON Patch format in use case code
• 6) Patch arrays, not entities in use cases
• 7) Wikibase REST API work-in-progress endpoints
• 8) Throw exceptions instead of returning response objects in use cases
• 9) Introduce read models
• 10) Validate fully in the REST API deserializers
• 11) Exception Handling and @throws Annotations in PHP Doc Blocks
• 12) Introducing Properties in the REST API
• 13) Make single statement use cases subject agnostic