FEDeepDive / DaliyPost

👀 개발 관련 읽을거리 공유 및 리딩
0 stars 0 forks source link

커뮤니티실 API Design-First 접근방식 정착기 #84

Open uraflower opened 1 month ago

uraflower commented 1 month ago

커뮤니티실 API Design-First 접근방식 정착기

제가 개발에 있어서 중요하게 생각하는 것 중 하나가 바로 '팀원 모두가 같은 것을 바라보고 나아가는 것'입니다. '사과'를 생각했을 때, 누구는 초록색 사과, 누구는 빨간색 사과, 누구는 한 입 베어문 사과를 생각할 수 있잖아요. '다들 당연히 빨간색 사과를 상상하겠지?'라고 생각하는 순간, 그 순간부터 의사소통의 오류가 생기고 보이지 않는 문제가 점점 커지고 팀원 간 오해가 생길 수 있기 때문입니다.

그래서 잘 정의된 규칙, 명세, 확실한 의사소통이 매우 중요하다고 생각해요. 당근마켓에서는 OAS라는 언어를 사용해서 규격화된 API를 설계하고 있다고 합니다. 모두가 동일한 걸 바라보며 개발하는 걸 정말 중요하게 생각하는 사람으로서... 좋은 방식인 것 같네요 !

hatchling13 commented 1 month ago

중요한 점을 짚어주셨고, 그에 맞는 좋은 글을 가져와주셔서 감사합니다!

결은 같은데 약간 다른 이야기를 하자면, 아이디어를 제품으로 구현하기 위해 요구사항이라는 형태로 명확하게 정제해내는 게 이상적인 기획이라고 생각합니다. 이 과정에서 제품 개발에 참여한 모두가 동의하는 용어를 정의하는 게 중요하다는 걸 저번에 참여했던 프로젝트에서 새삼 느낄 수 있었는데요. 어떤 기능에 대해 서로 사용하는 용어가 다르다거나 특정 용어를 서로 다르게 이해하고 있는 걸 실제로 확인할 때의 막막함이 지금도 기억납니다.

표현력이 풍부한 자연 언어를 사용할 때도 이런데 인터페이스는 오죽할까 하는 생각이 많이 들었는데, 덕분에 이런 방법이 있구나 하는 걸 알고 가네요! 👍