<aside> 💡 상속을 고려한 설계와 문서화란 정확히 무엇일까?

</aside>

• 메서드를 재정의하면 어떤 일이 일어나는지를 정확히 정리하여 문서로 남겨야 한다.
  • 상속용 클래스는 재정의할 수 있는 메서드들을 내부적으로 어떻게 이용하는지 문서로 남겨야 한다.
  • 어떤 순서로 호출하는지, 각각의 호출 결과가 이어지는 처리에 어떤 영향을 주는지도 담아야 한다.

→ 하지만, 이런 식은 좋은 API 문서란 어떻게가 아닌 무엇을 하는지를 설명해야 한다 라는 격언과는 다르다!

• 클래스를 안전하게 상속할 수 있도록 하려면 내부 구현 방식을 설명해야만 한다.
  • 메서드의 내부 동작을 설명하는 주석인 @implSpec 태그는 기본값이 아니다.

효율적인 하위 클래스를 큰 어려움 없이 만들 수 있게 하려면?

→ 클래스의 내부 동작 과정 중간에 끼어들 수 있는 hook을 잘 선별하여 protected 메서드 형태로 공개해야 할 수도 있다.