https://swift.org/documentation/api-design-guidelines/
-
์ฌ์ฉํ ๋ ๊ธฐ์ค์ผ๋ก ๋ช ํํ๊ฒ ์์ฑํ๋ ๊ฒ ๊ฐ์ฅ ์ค์ํ ์งํฅ์ ์ด๋ค. ๋ฉ์๋๋ ํ๋กํผํฐ ๊ฐ์ ๊ฐ๋ฐ ์์๋ ํ ๋ฒ๋ง ์ ์ธํ๊ณ ๋ฐ๋ณต์ ์ผ๋ก ์ฌ์ฉํ๋ค. API๋ฅผ ๋ง๋ค ๋๋ ์ฌ์ฉํ๊ธฐ ๋ช ํํ๊ณ ํธํ๊ฒ ๋ง๋ค์ด์ผ ํ๋ค. ์ค๊ณ๋ฅผ ๊ฒ์ฆํ ๋ ์ ์ธ ๋ถ๋ถ์ ์ฝ๋ ๊ฒ๋ง์ผ๋ก๋ ๋ถ์กฑํ๋ค. ๊ทธ ๋์ ์ฌ์ฉํ๋ ์ํฉ์์ ๋งฅ๋ฝ์ ๋ง๊ณ ๋ช ํํ ์ง ๋ ๊ณ ๋ คํด์ผ ํ๋ค.
-
๋ช ํํ ํํ์ด ์์ถํ ๊ฐ๊ฒฐ์ฑ๋ณด๋ค ๋ ์ค์ํ๋ค. ์ค์ํํธ ์ฝ๋๋ ์์ถํด์ ๊ฐ๊ฒฐํ๊ฒ ์์ฑํ ์ ์์ง๋ง, ๋จ์ง ๊ธ์์๋ฅผ ์ค์ฌ์ ๊ฐ์ฅ ์งง์ ์ฝ๋๋ฅผ ๋ง๋๋ ๊ฒ ๋ชฉํ๋ ์๋๋ค. ์ค์ํํธ ์ฝ๋์ ๊ฐ๊ฒฐ์ฑ์ ์์ฐ์ค๋ฝ๊ฒ ๋ฐ๋ณต์ ์ผ๋ก ์ฌ์ฌ์ฉํ๋ ์ฝ๋(boilerplate)๋ฅผ ์ค์ด๋ ๊ธฐ๋ฅ๊ณผ ๊ฐํ ํ์ ์์คํ ์ ๋ถ์ํจ๊ณผ๋ก ๋๋ฌ๋ ๋ฟ์ด๋ค.