Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

ADR003 - Required Date

ADRs must include the date when the decision was made.

Why This Rule Exists

Dates provide:

  • Historical context for when decisions were made
  • Timeline for understanding decision evolution
  • Reference for when to revisit decisions

Formats

Nygard Format

Date appears on a line after the title:

# 1. Use Rust

Date: 2024-01-15

MADR Format

Date is in YAML frontmatter:

---
status: accepted
date: 2024-01-15
---

Examples

Incorrect

# 1. Use Rust

## Status

Accepted

Missing date.

Correct (Nygard)

# 1. Use Rust

Date: 2024-01-15

## Status

Accepted

Correct (MADR)

---
status: accepted
date: 2024-01-15
---

# Use Rust

Rule Details

  • Rule ID: ADR003
  • Name: adr-required-date
  • Category: Structure
  • Severity: Error
  • Automatic Fix: Not available
  • ADR008 - Date format validation