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

ADR016 - Considered Options Format

In MADR format, the Considered Options section should list at least 2 options.

Why This Rule Exists

Multiple options demonstrate:

  • Alternatives were evaluated
  • Due diligence was performed
  • The decision wasn't predetermined
  • Trade-offs were considered

Format

List at least 2 options as bullets or H3 headings:

## Considered Options

* PostgreSQL
* MySQL
* MongoDB

Or with detailed subsections:

## Considered Options

### PostgreSQL

A mature relational database with excellent SQL support.

### MySQL

A widely-used relational database with good performance.

### MongoDB

A document database for flexible schemas.

Examples

Incorrect

## Considered Options

* PostgreSQL

Only one option listed.

Correct

## Considered Options

* PostgreSQL
* MySQL
* MongoDB

Configuration

Customize minimum options:

[ADR016]
min-options = 2  # Default

Rule Details

  • Rule ID: ADR016
  • Name: adr-considered-options-format
  • Category: Content
  • Severity: Info
  • Applies to: MADR format only
  • Automatic Fix: Not available
  • ADR015 - Decision Drivers format
  • ADR017 - Consequences structure