예시를 제공하라

구체적인 예시 하나가 한 단락의 설명만큼 값지다. 출력이 특정 형태이길 원한다면, 그 형태를 보여줘라. 이것이 모호함을 없애는 가장 빠른 방법이다.

데이터를 보기 좋게 포맷해줘.

이 사용자 배열을 요약 객체로 변환해줘.

입력:
  [{ name: "Ann", role: "admin" }, { name: "Bo", role: "user" }]

원하는 출력:
  { total: 2, byRole: { admin: ["Ann"], user: ["Bo"] } }

변환 함수와 이 예시에 맞는 테스트를 작성해줘.

예시는 말만으로는 흐릿하게 남는 명명, 구조, 대소문자를 못 박는다. 가능하다면 예시를 테스트로 포함하라 — 그러면 "테스트를 통과시켜줘"가 모호하지 않은 지시가 된다. 이 요령은 일반화된다: 샘플 API(애플리케이션 프로그래밍 인터페이스 — 한 프로그램이 다른 프로그램에 데이터를 요청하는 방식) 응답은 파서를 못 박고, 전/후 한 쌍은 리팩터링을 못 박고, 스크린샷이나 ASCII 스케치는 레이아웃을 못 박는다. 어떤 형태에 대한 긴 설명을 쓰고 있는 자신을 발견할 때마다, 멈추고 그 형태의 한 사례를 대신 보여줘라.