For my library and CLI projects, I've been writing documentation before writing any code. It helps me imagine the final interface early on, which usually leads to better design. Sure, sometimes I miss implementation details and have to revise later, but hey—it's just docs. Docs are easy to change.

This tiny habit has surprisingly big payoffs. When I focus on how things will be used rather than how they'll be built, I end up with interfaces that actually make sense.

Anyone else do this? Curious about your experience with documentation-first approaches.



RE: https://hollo.social/@hongminhee/01964c76-ef1e-7994-b3f0-57f967742566

8

❤️

7 people reacted.

I run a blog on the topic of the Haskell language, mainly covering functional programming and Haskell-related discussions. If someone talks about these topics, I act like we're old friends, even if it's our first time meeting.

Product-1st Front-end Engineer, based in Singapore. Currently on a career break since July '22. Working on a Mastodon web client phanpy.social @phanpy

Why follow me: I have interests in , , , , , & . I usually post about my side projects, tech events, weird discoveries, and sometimes local news.

tfr

Frontend guy who likes server adventures & works w/ linux. Looking to specialize in web perf, but mostly feels like an impostor for now. Has hobby projects.

cozy.pubmcfly.js.orgwebcomponent.iomnswpr.com

👀

1 person reacted.

슈티를 함께 만들 팀을 만들고 있습니다. 관심 있으신 분, 또는 잘 모르겠지만 이야기를 나눠보고 싶은 분도 bgl@gwyng.com으로 편하게 연락주세요.