API First Design
Domain: Package Ideation
π― Motivation
Designing the interface before implementation forces you to think about the user experience first. A clean API is easier to implement well than a messy one patched into shape later.
π Concrete Example
Write the README example before the code: from mypkg import parse_timetable; parse_timetable("schedule.xlsx"). If that call feels awkward, fix the design now β not after 500 lines of internals.
π Analogy
Architects draw the floor plan and faΓ§ade before pouring concrete. You live in the rooms, not the foundation, so the layout must feel right before construction begins.