Skip to content

Commit 075cb53

Browse files
brabojclaude
andcommitted
docs: add ADR-006 — hamburger menu for mobile navigation
Standardize on hamburger menu across all Code with Branko tutorials. Closes #101. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 986860c commit 075cb53

1 file changed

Lines changed: 26 additions & 0 deletions

File tree

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,26 @@
1+
# ADR-006: Hamburger menu for mobile navigation
2+
3+
**Status:** Accepted
4+
**Date:** 2026-04-20
5+
6+
## Context
7+
The Git tutorial (Astro site) needed a mobile navigation pattern. The Azure
8+
tutorial uses a hamburger menu; the Git tutorial initially used a horizontally
9+
scrollable tab bar. With 9 chapters, off-screen tabs were hard to discover.
10+
11+
## Decision
12+
Use a hamburger menu for mobile navigation (breakpoint at 768 px), matching
13+
the Azure tutorial. This becomes the standard pattern across all Code with
14+
Branko tutorials.
15+
16+
## Alternatives considered
17+
- **Horizontal scroll tabs**: Always visible, but items off-screen are not
18+
discoverable — users don't know there are more chapters to the right
19+
- **Collapsible sidebar**: More common in documentation sites, but heavier
20+
for a single-page tutorial layout
21+
22+
## Consequences
23+
- Hamburger menu is the standard mobile nav for all tutorials
24+
- Future tutorials inherit this pattern
25+
- Navigation is hidden behind a tap but all 9 chapters are visible at once
26+
when opened

0 commit comments

Comments
 (0)