laywill / laywill/laywill.github.io
Rework the coffee page around method, kit and a test-driven quip
Nobody has claimed this yet.
- Dominant language
- HTML
- Stars
- 0
- Forks
- 0
- Avg merge
- 8h 17m
- Merged PRs (30d)
- 58
Description
coffee.html is linked from William's CV ("opinionated about automation, linting, and how to brew a good cup of coffee"), so recruiters are likely to read it. As it stands it undersells the engineering angle: the intro calls the approach "a bit over-engineered for the problem at hand", and it links a notes repo that looks abandoned (two bean notes, last pushed March 2025).
Page structure
- Banner: new hero, Nathan Dumlao's latte-on-beans photo from Unsplash (
XOhI_kW_TaM), cropped 1:1 and centred on the cup, with an Unsplash credit badge like the other pages that use Unsplash photos. - Approach: a short intro that sets up the quip: "Every recipe here started as a baseline and got better by making one controlled change at a time. Test-driven brewing, more or less."
- Book spotlight: James Hoffmann's The Best Coffee at Home, a birthday gift William recommends. This replaces the Hoffmann sentence currently tacked onto the recipe.
- Grinder spotlight: a budget Breville conical burr grinder, still going after about ten years. Framed as a great-value purchase that has taken him a long way into the hobby.
- One method each, a spotlight for the kit and a recipe grid under it, including that method's grind setting:
- French press: the daily driver, over 95% of brews. 16g / 600ml / 92°C / 6 min, two cafetières into an insulated flask for four workday cups. The dose is deliberately lighter than Hoffmann's, and the copy says why.
- AeroPress: office and travel.
- Moka pot: espresso-style drinks at home, or when a recipe calls for one.
- Bean gallery: "Some of my favourite beans", photos of the bags with roaster, origin and process as captions. No tasting notes needed.
Out of scope for now
- The
coffee-notesrepo link is removed rather than kept, until the repo has enough in it to be worth linking.
Acceptance criteria
- "Over-engineered" wording is gone, and the new quip is present.
- No link to
github.com/laywill/coffee-notesremains on the page. - Every image is a real photo: no placeholder remains (the photos come from William: book, grinder, each brewer, bean bags).
- The AeroPress and Moka pot recipes and every method's grind setting are real numbers, not placeholders.
- The meta and OG descriptions,
llms.txtand the index card copy match the new page. - Every
.itemssection has itsinnerwrapper;check-renderpasses at desktop and 375px.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with coffee.html and inspect the existing page structure, metadata, OG descriptions, index card copy, and llms.txt references. Replace the specified content and real photos, then run check-render at desktop and 375px; done means all acceptance criteria pass, including the .items inner wrappers and removal of the coffee-notes link.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- html
- Domain
- content, web-dev
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100