TIL:10x개발자, 코드품질 올리기

10X 개발자 되기

- 가치 전달, 특히 기업의 비즈니스 가치 전달이 가장 우선되어야 함.

- 도움을 잘 요청하자.

- 사용하는 도구에 대한 연구 필요.

 

https://yozm.wishket.com/magazine/detail/1373/

 

 

코드 품질 올리기(링크: https://speakerdeck.com/pluu/kodeu-pumjil-1-percent-olrigi) 

소프트웨어를 계층으로 분리하고 종송석 규칙을 준수하여 본질적으로 테스트 가능한 시스템을 만든다.

 

좋은 API 설계 원칙 6가지(링크: https://thenewstack.io/werner-vogels-6-rules-for-good-api-design/) 

API는 영원하다: 한번 나가면 그 기반으로 비즈니스가 만들어 진다.API를 변경하면 비즈니스까 깨질 수 있다.

하위호환성을 절대로 깨지 마라. 필수!. 이전 버전의 API 호출이 발생했을 경우에 어떠한 영향도 안주도록 API를 개선해야 한다.

사용자 실제 사용예로 부터 업무를 시작하라. 엔지니어들이 어떻게 하면 좋은 API를 만들지로 부터 개발하지 말고, 사용자가 어떤 API를 원하는지 살펴본 다음 실제로 제공할 수 있는 가장 최소한의 단순한 형태로 만들기 시작해라.

자체가 설명이 잘 되고, 명확하고 지정된 목정을 가져야 한다. 문서도 잘 되어 있어야 하겠지만, 우선 직관적이어야 한다. API를 살펴보면 항상 그 API가 뭘하는지 알아야 한다.

명시적인 API를 만들고, 실패나 오류에 대해서는 잘 문서화해두자. 왜 동작이 실패했는지을 ㄹ알려줘야 함.

부족한 구현은 피해야 한다. 구현에 구멍이 있으면 고객들이 이 기반으로 점점 성장하게 되어 그 구현을 더이상 변경할 수 없다.

아마존이 만든 API 정의 도구: https://awslabs.github.io/smithy/ Smithy?