461: Writing new vs existing code with Sara Jackson

What It Covers

Sara Jackson and Joelle Kenville compare greenfield development versus maintaining established codebases, exploring how different constraints, documentation practices, and technical decisions shape each modality and affect future developers working on the same code.

Key Questions Answered

• •Documentation timing trade-offs: Greenfield teams sacrifice speed writing documentation that won't benefit them immediately but becomes critical for future maintainers. Commit messages and inline comments provide low-effort alternatives that help both current iteration speed and future code archaeology.
• •API design approaches: Greenfield projects can skip input validation and schemas when always adding new endpoints, but mature apps modifying existing endpoints need tools like Zod or GraphQL schemas from the start to prevent production bugs from breaking changes across front-end and back-end teams.
• •Convention over configuration advantage: Ruby on Rails bridges greenfield and mature modalities by providing standard patterns where developers immediately know controllers live in controllers folders. JavaScript apps require explicit pattern documentation since teams pick three from ten mainstream approaches each year.
• •Modular code benefits both phases: Writing modular, clean code helps greenfield teams iterate quickly when switching third-party tools while simultaneously making future changes cheaper for mature app developers, creating immediate value rather than just long-term benefits for maintenance teams.