사용 중지 용어

사용 중지 (Deprecation)

  • 기능을 사용 중지하거나 제거하기 전에 필요합니다.
  • 사용을 권장하지 않는 기능입니다.
  • 개발은 1순위/심각도 1 버그 수정으로 제한됩니다.
  • 향후 주요 릴리스에서 삭제될 예정입니다.
  • 사용 중지 일정 또는 제거 일정을 기재한 사용 중지 발표 이후 시작됩니다.
  • 지원 종료 날짜 또는 제거 날짜가 지나면 종료됩니다.

지원 종료 (End of Support)

  • 제거 전에 선택적으로 진행되는 단계입니다.
  • 기능 사용을 강력히 비추합니다.
  • 지원이나 수정이 제공되지 않습니다.
  • 내부적으로 더 이상 테스트되지 않습니다.
  • 향후 주요 릴리스에서 삭제될 예정입니다.
  • 지원 종료일이 지난 후 시작됩니다.

지원 종료 기간 공지은 특별한 경우에만 사용하며 일반적인 사용을 권장하지 않습니다. 대부분의 기능은 사용 중지된 후에 삭제되어야 합니다.

삭제 (Removal)

  • 기능을 더는 사용할 수 없게 됩니다.
  • 지원 종료 기간이 이미 공지되지 않은 경우, 해당 기능은 더 이상 지원되지 않습니다.
  • 우리의 의미있는 버전 관리 정책에 따라 주요 릴리스에서 수행됩니다.
  • 삭제 일정이 지난 후 시작됩니다.

주요 변경 (Breaking change)

“주요 변경”이란 사용자가 코드, 설정 또는 작업 흐름에 대응하는 변경을 요구하는 변경사항입니다. “사용자”는 사람, API 클라이언트 또는 다른 클래스를 “사용”하는 코드 클래스일 수 있습니다. 주요 변경 사례로는 다음이 있습니다:

  • 대체/대체 방안이 없이 사용자가 이용하는 기능 제거
  • 기존 API의 정의 변경(예: 쿼리 매개변수 이름 변경 또는 경로 변경)
  • 클래스에서 공개 메소드를 제거

주요 변경은 많은 사용자에게 영향을 미치거나 행동의 중요한 변경을 나타내는 경우 주요 변경으로 간주될 수 있습니다.