[Effective Kotlin] Item 28 : Specify API stability

이 글은 Effective Java 를 완독하고, Kotlin 을 상용으로 사용하는 개발자 입장에서
Effective Kotlin 글 중 새로운 내용, remind 할 필요 있는 부분, 핵심 내용 등만 추려 정리한 내용입니다.

 

#
프로그래머들은 안정적이고 공식적인 API 를 쓰긴 원한다. 그 이유는..

1. API 변화는 개발자에게 코드 업데이트를 요구한다.
2. API 변화/추가는 새로운 API 를 학습과 지식의 업데이트를 요구한다.

 

#
API 중 안정적이지 않은 부분을 문서에 잘 명시하는 것이 중요하다.

 

#
Semantic Versioning (SemVer) 는 Major.Minor.Patch 로 버전을 구분하는 버저닝을 이야기한다.
Major 는 하위 호환되지 않는 API 변화가 있을 때, Minor 는 하위호환되는 함수 추가 등이 있을 때, Patch 는 하위호환되는 버그 수정 등이 있을 때 올려 사용한다.

 

#
Deprected, Experimental 등이 안정성 측면에서 사용된다.

 

 

Summary

#
버전명, 이름, annotation 등으로 안정성을 이야기한다.

 

끝