# Polish Report — Paul Graham Homepage

## Source observations

The original page (paulgraham.com, lines 1–74) is built entirely with HTML 3-era techniques: `bgcolor`, `<font>` tags, nested `<table>` layout, an image-map sidebar (`<map>` / `<area>`) for all navigation, and two banner tables using fixed-pixel widths and `bgcolor` for colour. Navigation destinations exist only as pixel coordinates inside a GIF image-map; they are invisible to screen readers, search engines, and users who cannot load the image. The copyright reads `© mmxxvi pg`. Content is sparse: two recent-essay notices and a Y Combinator pitch. No scripts or forms were preserved; the original scripts were Turbify store utilities unrelated to the page content.

## Changes made

| Area | Before | After |
|---|---|---|
| Navigation | Image-map GIF with 18 coordinate links | Semantic `<nav>` with four labelled sections and plain `<a>` links |
| Layout | Fixed-pixel nested tables | Single-column fluid layout, max 660 px, responsive grid for nav links |
| Typography | `<font face="verdana" size="2">` | `system-ui` body; 'Concept Display' serif for heading only |
| Colour | `bgcolor="#ffcc33"` / `bgcolor="#ff9922"` banners | Quiet warm-ivory notices with single-pixel left rules (amber / orange) |
| Hierarchy | Flat — banners and nav at equal weight | Header → notices → nav sections → footer; section headings in small-caps |
| "New" banner | Yellow table row with bold label | Warm-ivory strip with thin left rule; bold label retained |
| YC banner | Orange table row | Warm-cream strip with thin orange rule |
| Footer | `color:#cccccc` near-invisible copyright | Readable mid-grey copyright + disclosure + link to original |
| Accessibility | No headings, no landmark regions | `<main>`, `<header>`, `<nav>`, `<footer>`, `aria-label`, semantic `<h1>`/`<h2>` |
| Responsive | Fixed 410 px wide, unusable on mobile | Fluid; two-column nav grid collapses to single column below 480 px |

## Facts preserved

- All 18 original image-map destinations converted to text links, grouped by topic.
- Both recent-essay links (`powerful.html`, `prepare.html`) kept in the "New" notice.
- Y Combinator `apply.html` link preserved verbatim.
- Copyright string `© mmxxvi pg` unchanged.
- No biography, quotes, dates, or images invented.

## Manual checks still needed

- **Link accuracy:** several URLs (`kedrosky.html`, `ind.html`, `quo.html`, `raq.html`) point to pages that may redirect or return 404; verify before shipping.
- **Colour contrast:** amber and orange notice left-rule colours should be verified against WCAG AA for any text placed on those backgrounds (current text is on the ivory background, not the rule).
- **Concept Display font:** rendered by the platform embedder; verify fallback appearance (Georgia) in environments where it is absent.
- **RSS link:** points to an Aaron Swartz-era feed URL (`aaronsw.com`); the original also listed this — confirm whether it is still live.
- **`kedrosky.html`** had no visible label in the original page copy; its purpose may need a clearer label once confirmed.