ํจ๊ณผ์ ์ธ ๋ฌธ์ ์์ฑ ๊ธฐ์ ์ ๋ง์คํฐํ์ธ์. ๊ธ๋ก๋ฒ ํ๊ณผ ์ ์ธ๊ณ ์ฌ์ฉ์์๊ฒ ์ ์ฉํ ๋ฌธ์ ์์ฑ ๋ชจ๋ฒ ์ฌ๋ก, ๋๊ตฌ, ์ ๋ต์ ์์๋ด ๋๋ค.
๋ฐ์ด๋ ๋ฌธ์ ์์ฑ๋ฒ: ๊ธ๋ก๋ฒ ํ์ ์ํ ์ข ํฉ ๊ฐ์ด๋
์ค๋๋ ๊ณผ ๊ฐ์ด ์ํธ ์ฐ๊ฒฐ๋ ์ธ์์์ ๋ช ํํ๊ณ ํฌ๊ด์ ์ธ ๋ฌธ์๋ ๊ทธ ์ด๋ ๋๋ณด๋ค ์ค์ํฉ๋๋ค. ์ํํธ์จ์ด๋ฅผ ๊ฐ๋ฐํ๋ , ์ ํ์ ์ ์กฐํ๋ , ์๋น์ค๋ฅผ ์ ๊ณตํ๋ , ์ ๋ง๋ค์ด์ง ๋ฌธ์๋ ์ฌ์ฉ์, ๊ฐ๋ฐ์, ๋ด๋ถ ํ์ด ์ฌ๋ฌ๋ถ์ ์ ํ๊ณผ ์๋น์ค๋ฅผ ํจ๊ณผ์ ์ผ๋ก ์ดํดํ๊ณ , ์ฌ์ฉํ๊ณ , ์ ์ง ๊ด๋ฆฌํ ์ ์๋๋ก ๋ณด์ฅํฉ๋๋ค. ์ด ๊ฐ์ด๋๋ ๊ธ๋ก๋ฒ ํ์ ์ํ ๋ฐ์ด๋ ๋ฌธ์ ์์ฑ์ ๋ํ ํฌ๊ด์ ์ธ ๊ฐ์๋ฅผ ์ ๊ณตํ๋ฉฐ, ์ฑ๊ณต์ ์ํ ๋ชจ๋ฒ ์ฌ๋ก, ๋๊ตฌ ๋ฐ ์ ๋ต์ ๋ค๋ฃน๋๋ค.
๊ธ๋ก๋ฒ ํ์๊ฒ ๋ฌธ์ํ๊ฐ ์ค์ํ ์ด์ ๋ ๋ฌด์์ผ๊น์?
๋ฌธ์๋ ์ค์ ์ ๋ณด ์์ค ์ญํ ์ ํ์ฌ ์ง๋ฆฌ์ ์ผ๋ก ๋ถ์ฐ๋ ํ ๊ฐ์ ํ์ , ์จ๋ณด๋ฉ ๋ฐ ์ง์ ๊ณต์ ๋ฅผ ์ด์งํฉ๋๋ค. ๋ค์๊ณผ ๊ฐ์ ์์ธ์ผ๋ก ์ธํด ๊ธ๋ก๋ฒ ํ๊ฒฝ์์ ๊ทธ ์ค์์ฑ์ ๋์ฑ ์ปค์ง๋๋ค:
- ์ธ์ด ์ฅ๋ฒฝ: ๊ณ ํ์ง ๋ฌธ์๋ ๋ช ํํ๊ณ ๊ฐ๊ฒฐํ ์ค๋ช ๊ณผ ์๊ฐ ์๋ฃ๋ฅผ ์ ๊ณตํ์ฌ ์์ฌ์ํต ๊ฒฉ์ฐจ๋ฅผ ํด์ํ ์ ์์ต๋๋ค.
- ์๊ฐ๋ ์ฐจ์ด: ๋ฌธ์๋ ๋น๋๊ธฐ์ ํ์ ์ ๊ฐ๋ฅํ๊ฒ ํ์ฌ ํ์๋ค์ด ์์ ์ ์์น๋ ๊ทผ๋ฌด ์๊ฐ์ ๊ด๊ณ์์ด ์ ๋ณด์ ์ ๊ทผํ๊ณ ๋ฌธ์ ๋ฅผ ํด๊ฒฐํ ์ ์๋๋ก ํฉ๋๋ค.
- ๋ฌธํ์ ๋์์ค: ๋ฌธ์๋ ์ผ๋ฐ์ ์ผ๋ก ์ค๋ฆฝ์ฑ์ ์งํฅํด์ผ ํ์ง๋ง, ๋ฌธํ์ ๋งฅ๋ฝ์ ์ดํดํ๋ฉด ๋ ๋์ ์ดํด๋ฅผ ์ํด ์์์ ์ฉ์ด๋ฅผ ๋ง์ถคํํ๋ ๋ฐ ๋์์ด ๋ ์ ์์ต๋๋ค.
- ์ ๊ท ํ์ ์จ๋ณด๋ฉ: ํฌ๊ด์ ์ธ ๋ฌธ์๋ ์ ๊ท ์ฑ์ฉ์์ ํ์ต ๊ณก์ ์ ํฌ๊ฒ ์ค์ฌ์ฃผ์ด ํ์ ์์ฐ์ ์ธ ๊ตฌ์ฑ์์ผ๋ก ๋น ๋ฅด๊ฒ ์๋ฆฌ ์ก์ ์ ์๋๋ก ํฉ๋๋ค.
- ์ง์ ๋ณด์กด: ๋ฌธ์๋ ์กฐ์ง์ ์ง์์ ๋ณด์กดํ์ฌ ์ง์์ด ํด์ฌํ๊ฑฐ๋ ์ญํ ์ ๋ณ๊ฒฝํ ๋ ์ค์ํ ์ ๋ณด๋ฅผ ์์ ์ํ์ ์ํํฉ๋๋ค.
- ์ ํ ํ์ง ํฅ์: ๋ช ํํ ๋ฌธ์๋ ๊ฐ๋ฐ์๊ฐ ์ ํ ์๊ตฌ์ฌํญ์ ์ ํํ๊ฒ ์ดํดํ๋๋ก ํ์ฌ ์ค๋ฅ๋ฅผ ์ค์ด๊ณ ๋ ๊ฒฌ๊ณ ํ ์ ํ์ ๋ง๋ค ์ ์๊ฒ ํฉ๋๋ค.
๋ฌธ์์ ์ข ๋ฅ
ํ์ํ ๋ฌธ์์ ์ ํ์ ๋ฌธ์ํ๋๋ ํน์ ์ ํ, ์๋น์ค ๋๋ ํ๋ก์ธ์ค์ ๋ฐ๋ผ ๋ค๋ฆ ๋๋ค. ์ผ๋ฐ์ ์ธ ์ ํ์ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
- ์ฌ์ฉ์ ๋งค๋ด์ผ: ์ต์ข ์ฌ์ฉ์์๊ฒ ์ ํ ๋๋ ์๋น์ค ์ฌ์ฉ ๋ฐฉ๋ฒ์ ๋ํ ์ง์นจ๊ณผ ์๋ด๋ฅผ ์ ๊ณตํฉ๋๋ค.
- API ๋ฌธ์: ์ ํ๋ฆฌ์ผ์ด์ ํ๋ก๊ทธ๋๋ฐ ์ธํฐํ์ด์ค(API)์ ์ธํฐํ์ด์ค์ ๊ธฐ๋ฅ์ ์ค๋ช ํ์ฌ ๊ฐ๋ฐ์๊ฐ API์ ํตํฉํ ์ ์๋๋ก ํฉ๋๋ค.
- ๊ธฐ์ ์ฌ์์: ์ ํ์ ์ค๊ณ, ๊ธฐ๋ฅ ๋ฐ ์ฑ๋ฅ์ ํฌํจํ ๊ธฐ์ ์ ์ธก๋ฉด์ ์์ธํ ์ค๋ช ํฉ๋๋ค.
- ์ํคํ ์ฒ ๋ฌธ์: ์ฃผ์ ๊ตฌ์ฑ ์์์ ์ํธ ์์ฉ์ ํฌํจํ ์ ์ฒด ์์คํ ์ํคํ ์ฒ๋ฅผ ์ค๋ช ํฉ๋๋ค.
- ์ฝ๋ ๋ฌธ์: ์์ค ์ฝ๋ ๋ด์ ์ฃผ์๊ณผ ๋ฌธ์๋ก, ๊ทธ ๋ชฉ์ ๊ณผ ๊ธฐ๋ฅ์ ์ค๋ช ํฉ๋๋ค.
- ๋ฆด๋ฆฌ์ค ๋ ธํธ: ์ ํ ๋๋ ์๋น์ค์ ์ ๋ฆด๋ฆฌ์ค์ ํฌํจ๋ ๋ณ๊ฒฝ ์ฌํญ, ๊ฐ์ ์ฌํญ ๋ฐ ๋ฒ๊ทธ ์์ ์ ์ค๋ช ํฉ๋๋ค.
- ์ง์ ๋ฒ ์ด์ค ๋ฌธ์: ์ผ๋ฐ์ ์ธ ์ง๋ฌธ๊ณผ ๋ฌธ์ ๋ฅผ ๋ค๋ฃจ๋ฉฐ ํด๊ฒฐ์ฑ ๊ณผ ๋ฌธ์ ํด๊ฒฐ ํ์ ์ ๊ณตํฉ๋๋ค.
- ํํ ๋ฆฌ์ผ ๋ฐ ๋ฐฉ๋ฒ ๊ฐ์ด๋: ํน์ ์์ ์ ์ํํ๋ ๋ฐฉ๋ฒ์ ๋ํ ๋จ๊ณ๋ณ ์ง์นจ์ ์ ๊ณตํฉ๋๋ค.
- ๋ด๋ถ ๋ฌธ์: ์ง์์ ์ํ ํ๋ก์ธ์ค, ์ ์ฐจ ๋ฐ ์ ์ฑ ์ ๋๋ค.
ํจ๊ณผ์ ์ธ ๋ฌธ์ ์์ฑ์ ์ํ ๋ชจ๋ฒ ์ฌ๋ก
๊ณ ํ์ง ๋ฌธ์๋ฅผ ์์ฑํ๋ ค๋ฉด ์ ๋ต์ ์ธ ์ ๊ทผ๊ณผ ์ธ๋ถ ์ฌํญ์ ๋ํ ์ฃผ์๊ฐ ํ์ํฉ๋๋ค. ๋ฐ๋ผ์ผ ํ ๋ช ๊ฐ์ง ๋ชจ๋ฒ ์ฌ๋ก๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
1. ๋์๊ณผ ๋ชฉ์ ์ ์
์์ฑ์ ์์ํ๊ธฐ ์ ์ ๋์ ๋ ์์ ๋ฌธ์์ ๋ชฉ์ ์ ๋ช ํํ ํ์ญ์์ค. ๋ ์์ ๊ธฐ์ ์ ๋ฐฐ๊ฒฝ, ์ ๋ฌธ ์ง์ ์์ค, ํด๊ฒฐํ๋ ค๋ ํน์ ์ง๋ฌธ์ด๋ ๋ฌธ์ ๋ฅผ ๊ณ ๋ คํด์ผ ํฉ๋๋ค. ์๋ฅผ ๋ค์ด, ์ด๋ณด ์ฌ์ฉ์๋ฅผ ์ํ ๋ฌธ์๋ ์ ๋ฌธ ๊ฐ๋ฐ์๋ฅผ ๋์์ผ๋ก ํ๋ ๋ฌธ์์ ๋ฌ๋ผ์ผ ํฉ๋๋ค. ๋์์ ์ดํดํ๋ฉด ์ฝํ ์ธ ๊ฐ ๊ด๋ จ์ฑ ์๊ณ , ์ ๊ทผ ๊ฐ๋ฅํ๋ฉฐ, ํจ๊ณผ์ ์ด๋๋ก ๋ณด์ฅํ ์ ์์ต๋๋ค.
2. ๋ฌธ์ ๊ณํ ๋ฐ ๊ตฌ์กฐํ
์ ๊ตฌ์กฐํ๋ ๋ฌธ์๋ ์ฝ๊ณ ์ดํดํ๊ธฐ ๋ ์ฝ์ต๋๋ค. ๊ฐ์๋ ๋ชฉ์ฐจ๋ฅผ ๋ง๋ค์ด ์ฝํ ์ธ ๋ฅผ ๋ ผ๋ฆฌ์ ์ผ๋ก ๊ตฌ์ฑํ์ธ์. ์ ๋ชฉ๊ณผ ๋ถ์ ๋ชฉ์ ์ฌ์ฉํ์ฌ ๊ธด ํ ์คํธ ๋ธ๋ก์ ๋๋๊ณ ๋ ์๊ฐ ๋ฌธ์๋ฅผ ์ฝ๊ฒ ํ์ํ ์ ์๋๋ก ์๋ดํ์ธ์. ๊ตฌ์กฐ๊ฐ ์ฌ์ฉ์์ ์ํฌํ๋ก์ฐ๋ ๋ฌธ์ํ๋๋ ์ ํ ๋๋ ์๋น์ค์ ๋ ผ๋ฆฌ์ ํ๋ฆ๊ณผ ์ผ์นํ๋์ง ํ์ธํ์ธ์.
3. ๋ช ํํ๊ณ ๊ฐ๊ฒฐํ ์ธ์ด ์ฌ์ฉ
๊ฐ๋ฅํ๋ฉด ์ ๋ฌธ ์ฉ์ด, ๊ธฐ์ ์ฉ์ด, ๋ณต์กํ ๋ฌธ์ฅ์ ํผํ์ธ์. ๋ ์์ ๋ชจ๊ตญ์ด๋ ๊ธฐ์ ์ ๋ฐฐ๊ฒฝ์ ๊ด๊ณ์์ด ์ดํดํ๊ธฐ ์ฌ์ด ๊ฐ๋จํ๊ณ ์ง์ค์ ์ธ ์ธ์ด๋ฅผ ์ฌ์ฉํ์ธ์. ๋ฅ๋ํ๋ก ์์ฑํ๊ณ ์งง์ ๋จ๋ฝ์ ์ฌ์ฉํ์ฌ ๊ฐ๋ ์ฑ์ ๋์ด์ธ์. ์คํ์ผ ๊ฐ์ด๋๋ฅผ ์ฌ์ฉํ์ฌ ์ด์กฐ์ ์ฉ์ด์ ์ผ๊ด์ฑ์ ์ ์งํ๋ ๊ฒ์ ๊ณ ๋ คํ์ธ์.
์์:
๋ค์ ๋์ : "์์คํ ์ 'initiate()' ๋ฉ์๋๋ฅผ ํธ์ถํ์ฌ ์ด๊ธฐํ๋์ด์ผ ํฉ๋๋ค."
์ด๋ ๊ฒ ์์ฑํ์ธ์: "์์คํ ์ ์์ํ๋ ค๋ฉด 'initiate()' ๋ฉ์๋๋ฅผ ์ฌ์ฉํ์ธ์."
4. ์์์ ์๊ฐ ์๋ฃ ์ ๊ณต
์์์ ์๊ฐ ์๋ฃ๋ ์ดํด๋๋ฅผ ํฌ๊ฒ ํฅ์์ํฌ ์ ์์ต๋๋ค. ์ฝ๋ ์ค๋ํซ, ์คํฌ๋ฆฐ์ท, ๋ค์ด์ด๊ทธ๋จ, ๋น๋์ค๋ฅผ ํฌํจํ์ฌ ๊ฐ๋ ๊ณผ ์ ์ฐจ๋ฅผ ์ค๋ช ํ์ธ์. ์์๊ฐ ๊ด๋ จ์ฑ ์๊ณ , ์ ๋ฌธ์ํ๋์ด ์์ผ๋ฉฐ, ๋ฐ๋ผํ๊ธฐ ์ฌ์ด์ง ํ์ธํ์ธ์. ์๊ฐ ์๋ฃ๋ ๋ณต์กํ ์ฃผ์ ๋ฅผ ๋ช ํํ ํ๊ณ ๋ฌธ์๋ฅผ ๋ ํฅ๋ฏธ๋กญ๊ฒ ๋ง๋๋ ๋ฐ ๋์์ด ๋ ์ ์์ต๋๋ค.
5. ์ ํํ๊ณ ์ต์ ์ ๋ณด ์ ์ง
๋ฌธ์์์ ์ ํ์ฑ์ ๊ฐ์ฅ ์ค์ํฉ๋๋ค. ๋ชจ๋ ์ ๋ณด๊ฐ ์ ํํ๊ณ ๊ฒ์ฆ๋์๋์ง ํ์ธํ์ธ์. ์ต์ ์ ํ ๋๋ ์๋น์ค ๋ณ๊ฒฝ ์ฌํญ์ผ๋ก ๋ฌธ์๋ฅผ ์ต์ ์ํ๋ก ์ ์งํ์ธ์. ์ ๊ธฐ์ ์ผ๋ก ๋ฌธ์๋ฅผ ๊ฒํ ํ๊ณ ์ ๋ฐ์ดํธํ์ฌ ์๋ก์ด ๊ธฐ๋ฅ, ๋ฒ๊ทธ ์์ ๋ฐ ๊ฐ์ ์ฌํญ์ ๋ฐ์ํ์ธ์. ๋ณ๊ฒฝ ์ฌํญ์ ์ถ์ ํ๊ณ ์์ ์ด๋ ฅ์ ์ ์งํ๊ธฐ ์ํด ๋ฒ์ ๊ด๋ฆฌ ์์คํ ์ ๊ตฌํํ๋ ๊ฒ์ ๊ณ ๋ คํ์ธ์.
6. ๋ฌธ์ ํ ์คํธ
๋ฌธ์๋ฅผ ๊ฒ์ํ๊ธฐ ์ ์ ๋ค๋ฅธ ์ฌ๋์๊ฒ ๋ช ํ์ฑ, ์ ํ์ฑ ๋ฐ ์์ ์ฑ์ ๊ฒํ ํ๋๋ก ํ์ธ์. ์ด์์ ์ผ๋ก๋ ๊ฒํ ์๊ฐ ๋์ ๋ ์ ์ค ํ ๋ช ์ด์ด์ผ ํฉ๋๋ค. ๊ทธ๋ค์๊ฒ ๋ฌธ์๋ฅผ ์ฌ์ฉํ์ฌ ํน์ ์์ ์ ์ํํ๋๋ก ์์ฒญํ๊ณ ๊ฒฝํ์ ๋ํ ํผ๋๋ฐฑ์ ์ ๊ณตํ๋๋ก ํ์ธ์. ๊ทธ๋ค์ ํผ๋๋ฐฑ์ ์ฌ์ฉํ์ฌ ๋ฌธ์๋ฅผ ๊ฐ์ ํ๊ณ ์ฌ์ฉ์์ ์๊ตฌ๋ฅผ ์ถฉ์กฑํ๋์ง ํ์ธํ์ธ์.
7. ๊ฒ์ ๊ฐ๋ฅํ๊ฒ ๋ง๋ค๊ธฐ
์ฌ์ฉ์๊ฐ ํ์ํ ์ ๋ณด๋ฅผ ์ ์ํ๊ฒ ์ฐพ์ ์ ์๋๋ก ๊ฐ๋ ฅํ ๊ฒ์ ๊ธฐ๋ฅ์ ๊ตฌํํ์ธ์. ๊ด๋ จ ํค์๋์ ํ๊ทธ๋ฅผ ์ฌ์ฉํ์ฌ ๋ฌธ์๋ฅผ ์ฝ๊ฒ ์ฐพ์ ์ ์๋๋ก ๋ง๋์ธ์. ์ถ๊ฐ ๊ฒ์ ์ต์ ์ ์ ๊ณตํ๊ธฐ ์ํด ์์ธ์ด๋ ์ฉ์ด์ง์ ๋ง๋๋ ๊ฒ์ ๊ณ ๋ คํ์ธ์. ๊ฒ์ ๊ฒฐ๊ณผ๊ฐ ์ ํํ๊ณ ๊ด๋ จ์ฑ์ด ์๋์ง ํ์ธํ์ธ์.
8. ํผ๋๋ฐฑ ๋ฉ์ปค๋์ฆ ์ ๊ณต
์ฌ์ฉ์๊ฐ ๋ฌธ์์ ๋ํ ํผ๋๋ฐฑ์ ์ ๊ณตํ๋๋ก ์ฅ๋ คํ์ธ์. ์ฌ์ฉ์๊ฐ ์ค๋ฅ๋ฅผ ๋ณด๊ณ ํ๊ฑฐ๋, ๊ฐ์ ์ฌํญ์ ์ ์ํ๊ฑฐ๋, ์ง๋ฌธ์ ํ ์ ์๋๋ก ํผ๋๋ฐฑ ์์์ด๋ ์ฐ๋ฝ์ฒ ์ ๋ณด๋ฅผ ํฌํจํ์ธ์. ํผ๋๋ฐฑ์ ์ ์ํ๊ฒ ์๋ตํ๊ณ ์ด๋ฅผ ์ฌ์ฉํ์ฌ ๋ฌธ์๋ฅผ ์ง์์ ์ผ๋ก ๊ฐ์ ํ์ธ์. ํผ๋๋ฐฑ ๋ฃจํ๋ฅผ ๋ง๋ค๋ฉด ๋ฌธ์๊ฐ ๊ด๋ จ์ฑ ์๊ณ ์ ์ฉํ๊ฒ ์ ์ง๋๋๋ก ๋ณด์ฅํ ์ ์์ต๋๋ค.
9. ํ์งํ ๋ฐ ๋ฒ์ญ ๊ณ ๋ ค
์ ํ์ด๋ ์๋น์ค๊ฐ ์ฌ๋ฌ ๊ตญ๊ฐ์์ ์ฌ์ฉ๋๋ ๊ฒฝ์ฐ ๋ฌธ์๋ฅผ ๋ค๋ฅธ ์ธ์ด๋ก ๋ฒ์ญํ๋ ๊ฒ์ ๊ณ ๋ คํ์ธ์. ํ์งํ๋ ๊ฐ ๋์ ์์ฅ์ ํน์ ๋ฌธํ ๋ฐ ์ธ์ด ์๊ตฌ ์ฌํญ์ ๋ง๊ฒ ๋ฌธ์๋ฅผ ์กฐ์ ํ๋ ๊ฒ์ ํฌํจํฉ๋๋ค. ๋ฒ์ญ์ด ์ ํํ๊ณ ๋ฌธํ์ ์ผ๋ก ์ ์ ํ์ง ํ์ธํ์ธ์. ๊ณ ํ์ง ๊ฒฐ๊ณผ๋ฅผ ๋ณด์ฅํ๊ธฐ ์ํด ์ ๋ฌธ ๋ฒ์ญ ์๋น์ค๋ฅผ ์ฌ์ฉํ๋ ๊ฒ์ ๊ณ ๋ คํ์ธ์.
10. ์ ๊ทผ์ฑ
์ฅ์ ๊ฐ ์๋ ์ฌ์ฉ์๊ฐ ๋ฌธ์์ ์ ๊ทผํ ์ ์๋๋ก ๋ณด์ฅํ์ธ์. ์ด๋ฏธ์ง์ ๋์ฒด ํ ์คํธ๋ฅผ ์ฌ์ฉํ๊ณ , ๋น๋์ค์ ์บก์ ์ ์ ๊ณตํ๋ฉฐ, ๋ฌธ์๊ฐ ์คํฌ๋ฆฐ ๋ฆฌ๋์ ํธํ๋๋์ง ํ์ธํ์ธ์. ํฌ๊ด์ ์ธ ๋ฌธ์๋ฅผ ๋ง๋ค๊ธฐ ์ํด WCAG(์น ์ฝํ ์ธ ์ ๊ทผ์ฑ ๊ฐ์ด๋๋ผ์ธ)์ ๊ฐ์ ์ ๊ทผ์ฑ ์ง์นจ์ ์ค์ํ์ธ์.
๋ฌธ์ ์์ฑ ๋ฐ ๊ด๋ฆฌ ๋๊ตฌ
๊ฐ๋จํ ํ ์คํธ ํธ์ง๊ธฐ๋ถํฐ ์ ๊ตํ ๋ฌธ์ ํ๋ซํผ์ ์ด๋ฅด๊ธฐ๊น์ง ๋ฌธ์ ์์ฑ ๋ฐ ๊ด๋ฆฌ๋ฅผ ๋๋ ๋ค์ํ ๋๊ตฌ๋ฅผ ์ฌ์ฉํ ์ ์์ต๋๋ค. ๋ช ๊ฐ์ง ์ธ๊ธฐ ์๋ ์ต์ ์ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
- ๋งํฌ๋ค์ด ํธ์ง๊ธฐ: ๋งํฌ๋ค์ด์ ๋ฐฐ์ฐ๊ณ ์ฌ์ฉํ๊ธฐ ์ฌ์ด ๊ฒฝ๋ ๋งํฌ์ ์ธ์ด์ ๋๋ค. ๋ง์ ํ ์คํธ ํธ์ง๊ธฐ์ IDE(ํตํฉ ๊ฐ๋ฐ ํ๊ฒฝ)๊ฐ ๋งํฌ๋ค์ด์ ์ง์ํ๋ฏ๋ก ๋ฌธ์ ์์ฑ์ ๋๋ฆฌ ์ฌ์ฉ๋ฉ๋๋ค. ์์๋ก๋ Visual Studio Code, Atom, Sublime Text๊ฐ ์์ต๋๋ค.
- ์ ์ ์ฌ์ดํธ ์์ฑ๊ธฐ: ์ ์ ์ฌ์ดํธ ์์ฑ๊ธฐ(SSG)๋ฅผ ์ฌ์ฉํ๋ฉด ๋งํฌ๋ค์ด์ด๋ ๋ค๋ฅธ ๋งํฌ์ ์ธ์ด๋ก ์ ์ ์น์ฌ์ดํธ๋ฅผ ๋ง๋ค ์ ์์ต๋๋ค. ๋น ๋ฅด๊ณ ์์ ํ๋ฉฐ ๋ฐฐํฌํ๊ธฐ ์ฌ์ด ๋ฌธ์ ์น์ฌ์ดํธ๋ฅผ ๋ง๋๋ ๋ฐ ์ด์์ ์ ๋๋ค. ์์๋ก๋ Jekyll, Hugo, Gatsby๊ฐ ์์ต๋๋ค.
- ๋ฌธ์ ํ๋ซํผ: ์ ์ฉ ๋ฌธ์ ํ๋ซํผ์ ๋ฌธ์ ์์ฑ, ๊ด๋ฆฌ ๋ฐ ๊ฒ์๋ฅผ ์ํ ๋ค์ํ ๊ธฐ๋ฅ์ ์ ๊ณตํฉ๋๋ค. ์ข ์ข ๊ณต๋ ํธ์ง ๋๊ตฌ, ๋ฒ์ ๊ด๋ฆฌ, ๊ฒ์ ๊ธฐ๋ฅ ๋ฐ ๋ถ์ ๊ธฐ๋ฅ์ ํฌํจํฉ๋๋ค. ์์๋ก๋ Read the Docs, Confluence, GitBook์ด ์์ต๋๋ค.
- API ๋ฌธ์ ์์ฑ๊ธฐ: ์ด ๋๊ตฌ๋ค์ ์ฝ๋ ์ฃผ์์ด๋ API ์ ์ ํ์ผ์์ ์๋์ผ๋ก API ๋ฌธ์๋ฅผ ์์ฑํฉ๋๋ค. ๋ฌธ์ํ ํ๋ก์ธ์ค๋ฅผ ์๋ํํ์ฌ ์๋นํ ์๊ฐ๊ณผ ๋ ธ๋ ฅ์ ์ ์ฝํ ์ ์์ต๋๋ค. ์์๋ก๋ Swagger(OpenAPI), JSDoc, Sphinx๊ฐ ์์ต๋๋ค.
- ์ง์ ๋ฒ ์ด์ค ์ํํธ์จ์ด: ์ง์ ๋ฒ ์ด์ค ์ํํธ์จ์ด๋ ์ง์ ๋ฒ ์ด์ค ๋ฌธ์๋ฅผ ์์ฑํ๊ณ ๊ด๋ฆฌํ๋๋ก ์ค๊ณ๋์์ต๋๋ค. ์ผ๋ฐ์ ์ผ๋ก ๊ฒ์, ๋ถ๋ฅ ๋ฐ ํผ๋๋ฐฑ ๋ฉ์ปค๋์ฆ๊ณผ ๊ฐ์ ๊ธฐ๋ฅ์ ํฌํจํฉ๋๋ค. ์์๋ก๋ Zendesk, Help Scout, Freshdesk๊ฐ ์์ต๋๋ค.
ํ์ ๋ฐ ์ํฌํ๋ก์ฐ
๋ฌธ์๋ ์ข ์ข ์ฌ๋ฌ ํ์์ด ์ฐธ์ฌํ๋ ํ์ ์์ ์ ๋๋ค. ๋ฌธ์ ์์ฑ, ๊ฒํ ๋ฐ ์ ๋ฐ์ดํธ๋ฅผ ์ํ ๋ช ํํ ์ํฌํ๋ก์ฐ๋ฅผ ์๋ฆฝํ์ธ์. Git๊ณผ ๊ฐ์ ๋ฒ์ ๊ด๋ฆฌ ์์คํ ์ ์ฌ์ฉํ์ฌ ๋ณ๊ฒฝ ์ฌํญ์ ์ถ์ ํ๊ณ ๊ธฐ์ฌ๋ฅผ ๊ด๋ฆฌํ์ธ์. ํ์ง๊ณผ ์ ํ์ฑ์ ๋ณด์ฅํ๊ธฐ ์ํด ์ฝ๋ ๊ฒํ ํ๋ก์ธ์ค๋ฅผ ๊ตฌํํ์ธ์. ํ์๋ค์ด ๋ฌธ์์ ๊ธฐ์ฌํ๊ณ ์ง์์ ๊ณต์ ํ๋๋ก ์ฅ๋ คํ์ธ์.
์ํฌํ๋ก์ฐ ์์:
- ํ์์ด ๋ฌธ์๋ฅผ ์์ฑํ๊ฑฐ๋ ์ ๋ฐ์ดํธํฉ๋๋ค.
- ๋ฌธ์๊ฐ ๊ฒํ ๋ฅผ ์ํด ์ ์ถ๋ฉ๋๋ค.
- ๊ฒํ ์๊ฐ ๋ฌธ์์ ์ ํ์ฑ, ๋ช ํ์ฑ ๋ฐ ์์ ์ฑ์ ํ์ธํฉ๋๋ค.
- ๊ฒํ ์๊ฐ ํผ๋๋ฐฑ์ ์ ๊ณตํ๊ณ ๋ณ๊ฒฝ์ ์ ์ํฉ๋๋ค.
- ์์ฑ์๊ฐ ํผ๋๋ฐฑ์ ๋ฐ์ํ๊ณ ๋ฌธ์๋ฅผ ๋ค์ ์ ์ถํฉ๋๋ค.
- ๋ฌธ์๊ฐ ์น์ธ๋๊ณ ๊ฒ์๋ฉ๋๋ค.
์ง์์ ์ธ ํ๋ก์ธ์ค๋ก์์ ๋ฌธ์ํ
๋ฌธ์ํ๋ฅผ ์ผํ์ฑ ์์ ์ผ๋ก ์ทจ๊ธํด์๋ ์ ๋ฉ๋๋ค. ์ด๋ ์ง์์ ์ธ ๊ด์ฌ๊ณผ ์ ์ง ๊ด๋ฆฌ๊ฐ ํ์ํ ์ง์์ ์ธ ํ๋ก์ธ์ค์ ๋๋ค. ์ ํ, ์๋น์ค ๋๋ ํ๋ก์ธ์ค์ ๋ณ๊ฒฝ ์ฌํญ์ ๋ฐ์ํ๊ธฐ ์ํด ์ ๊ธฐ์ ์ผ๋ก ๋ฌธ์๋ฅผ ๊ฒํ ํ๊ณ ์ ๋ฐ์ดํธํ์ธ์. ์ฌ์ฉ์๋ก๋ถํฐ ํผ๋๋ฐฑ์ ์์ฒญํ๊ณ ์ด๋ฅผ ์ฌ์ฉํ์ฌ ๋ฌธ์๋ฅผ ๊ฐ์ ํ์ธ์. ๋ฌธ์ํ๋ฅผ ์กฐ์ง์ ์ฑ๊ณต์ ๊ธฐ์ฌํ๋ ๊ท์คํ ์์ฐ์ผ๋ก ์ทจ๊ธํ์ธ์.
๋ฌธ์ ํจ์จ์ฑ ์ธก์
๋ฌธ์๊ฐ ์ฌ์ฉ์์ ์๊ตฌ๋ฅผ ์ถฉ์กฑํ๋์ง ํ์ธํ๊ธฐ ์ํด ๋ฌธ์์ ํจ์จ์ฑ์ ์ธก์ ํ๋ ๊ฒ์ด ์ค์ํฉ๋๋ค. ๊ณ ๋ คํด์ผ ํ ๋ช ๊ฐ์ง ์งํ๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
- ํ์ด์ง ์กฐํ์: ํ์ด์ง ์กฐํ์๋ฅผ ์ถ์ ํ์ฌ ์ด๋ค ์ฃผ์ ๊ฐ ๊ฐ์ฅ ์ธ๊ธฐ ์๋์ง ํ์ธํฉ๋๋ค.
- ๊ฒ์์ด: ๊ฒ์์ด๋ฅผ ๋ถ์ํ์ฌ ๋ฌธ์์ ๊ณต๋ฐฑ์ ์๋ณํฉ๋๋ค.
- ํผ๋๋ฐฑ ํ์ : ํผ๋๋ฐฑ ํ์ ์ ์์งํ์ฌ ์ฌ์ฉ์ ๋ง์กฑ๋๋ฅผ ํ๊ฐํฉ๋๋ค.
- ์ง์ ํฐ์ผ: ์ง์ ํฐ์ผ์ ๋ชจ๋ํฐ๋งํ์ฌ ๋ฌธ์๊ฐ ๋ฌธ์ ์๋ฅผ ์ค์ด๋์ง ํ์ธํฉ๋๋ค.
- ์์ ์๋ฃ์จ: ์ฌ์ฉ์๊ฐ ๋ฌธ์๋ฅผ ์ฌ์ฉํ์ฌ ์์ ์ ์๋ฃํ๋ ์ฑ๊ณต๋ฅ ์ ์ธก์ ํฉ๋๋ค.
- ํ์ด์ง ์ฒด๋ฅ ์๊ฐ: ํ์ด์ง์์ ๋ณด๋ธ ์๊ฐ์ ์ฌ์ฉํ์ฌ ์ฝํ ์ธ ๊ฐ ๋ ์๋ฅผ ์ผ๋ง๋ ์ ์ ์งํ๋์ง ์ดํดํฉ๋๋ค.
์ด๋ฌํ ์งํ๋ฅผ ๋ชจ๋ํฐ๋งํจ์ผ๋ก์จ ๊ฐ์ ํ ์์ญ์ ์๋ณํ๊ณ ๋ฌธ์๊ฐ ํจ๊ณผ์ ์ธ์ง ํ์ธํ ์ ์์ต๋๋ค.
๋ฌธ์ํ์ ๋ํ ๊ธ๋ก๋ฒ ๊ณ ๋ ค์ฌํญ
๊ธ๋ก๋ฒ ๋ ์๋ฅผ ์ํ ๋ฌธ์๋ฅผ ์์ฑํ ๋ ์ ๋ณด๊ฐ ์ ๊ทผ ๊ฐ๋ฅํ๊ณ , ์ดํด ๊ฐ๋ฅํ๋ฉฐ, ๋ฌธํ์ ์ผ๋ก ์ ์ ํ์ง ํ์ธํ๊ธฐ ์ํด ์ฌ๋ฌ ์์๋ฅผ ๊ณ ๋ คํ๋ ๊ฒ์ด ํ์์ ์ ๋๋ค. ์ด๋ฌํ ๊ณ ๋ ค์ฌํญ์ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
- ํ์งํ ๋ฐ ๋ฒ์ญ: ๋ฌธ์๋ฅผ ์ฌ๋ฌ ์ธ์ด๋ก ๋ฒ์ญํ๋ ๊ฒ์ ๋ ๋์ ์ ์ฌ ๊ณ ๊ฐ์๊ฒ ๋ค๊ฐ๊ฐ๋ ๋ฐ ์ค์ํฉ๋๋ค. ์ ํ์ฑ๊ณผ ๋ฌธํ์ ๋ฏผ๊ฐ์ฑ์ ๋ณด์ฅํ๊ธฐ ์ํด ์ ๋ฌธ ๋ฒ์ญ ์๋น์ค๋ฅผ ์ฌ์ฉํ๋ ๊ฒ์ ๊ณ ๋ คํ์ธ์. ํ์งํ๋ ๋จ์ํ ๋ฒ์ญ์ ๋์ด ๋์ ๋ ์์ ํน์ ๋ฌธํ์ ๋งฅ๋ฝ์ ๋ง๊ฒ ์ฝํ ์ธ ๋ฅผ ์กฐ์ ํ๋ ๊ฒ์ ํฌํจํฉ๋๋ค.
- ๋ฌธํ์ ๋ฏผ๊ฐ์ฑ: ๋ฌธํ์ ์ฐจ์ด์ ์ ์ํ๊ณ ๋ชจ๋ ์ฌ๋์ด ์ดํดํ์ง ๋ชปํ ์ ์๋ ๊ด์ฉ๊ตฌ, ์์ด ๋๋ ์ ๋จธ ์ฌ์ฉ์ ํผํ์ธ์. ํฌ์ฉ์ ์ธ ์ธ์ด๋ฅผ ์ฌ์ฉํ๊ณ ๋ ์์ ๋ฐฐ๊ฒฝ์ด๋ ์ง์์ ๋ํด ๊ฐ์ ํ์ง ๋ง์ธ์.
- ์๊ฐ๋ ๋ฐ ๋ ์ง: ๋ ์ง์ ์๊ฐ์ ์ธ๊ธํ ๋ ๋ค๋ฅธ ์ง์ญ์ ์ฌ๋๋ค์ด ์ฝ๊ฒ ์ดํดํ ์ ์๋ ํ์์ ์ฌ์ฉํ์ธ์. UTC(ํ์ ์ธ๊ณ์)๋ฅผ ์ฌ์ฉํ๊ฑฐ๋ ์๊ฐ๋๋ฅผ ๋ช ์ํ๋ ๊ฒ์ ๊ณ ๋ คํ์ธ์.
- ์ธก์ ๋จ์: ๋์ ๋ ์์๊ฒ ์ ํฉํ ์ธก์ ๋จ์๋ฅผ ์ฌ์ฉํ์ธ์. ์ผ๋ถ ๊ตญ๊ฐ์์๋ ๋ฏธํฐ๋ฒ์ ์ฌ์ฉํ๊ณ ๋ค๋ฅธ ๊ตญ๊ฐ์์๋ ์ผ๋ํ์ด๋๋ฒ์ ์ฌ์ฉํฉ๋๋ค. ํ์ํ ๊ฒฝ์ฐ ๋ณํ ๊ฐ์ ์ ๊ณตํ์ธ์.
- ํตํ: ํตํ๋ฅผ ์ธ๊ธํ ๋ ๋์ ๋ ์์๊ฒ ์ ํฉํ ํตํ ๊ธฐํธ์ ํ์์ ์ฌ์ฉํ์ธ์. ํ์ํ ๊ฒฝ์ฐ ๋ณํ ๊ฐ์ ์ ๊ณตํ์ธ์.
- ๋ฒ์ ๋ฐ ๊ท์ ์๊ฑด: ๋ฌธ์๊ฐ ๋์ ์์ฅ์ ๋ชจ๋ ๊ด๋ จ ๋ฒ์ ๋ฐ ๊ท์ ์๊ฑด์ ์ค์ํ๋์ง ํ์ธํ์ธ์.
- ์ ๊ทผ์ฑ ํ์ค: ์์น์ ๊ด๊ณ์์ด ์ฅ์ ๊ฐ ์๋ ์ฌ์ฉ์๊ฐ ๋ฌธ์์ ์ ๊ทผํ ์ ์๋๋ก WCAG(์น ์ฝํ ์ธ ์ ๊ทผ์ฑ ๊ฐ์ด๋๋ผ์ธ)์ ๊ฐ์ ์ ๊ทผ์ฑ ํ์ค์ ์ค์ํ์ธ์.
ํ๋ฅญํ ๋ฌธ์์ ์์
๋ง์ ์กฐ์ง์ด ํ๋ฅญํ ๋ฌธ์๋ก ์ ๋ช ํฉ๋๋ค. ๋ช ๊ฐ์ง ์๋ ๋ค์๊ณผ ๊ฐ์ต๋๋ค:
- Stripe: Stripe์ API ๋ฌธ์๋ ๋ช ํ์ฑ, ์์ ์ฑ ๋ฐ ์ฌ์ฉ์ ์นํ์ฑ์ผ๋ก ๋๋ฆฌ ํธํ๋ฐ๊ณ ์์ต๋๋ค. ์์ธํ ์์, ๋ํํ ํํ ๋ฆฌ์ผ ๋ฐ ํฌ๊ด์ ์ธ ์ฐธ๊ณ ์๋ฃ๋ฅผ ์ ๊ณตํฉ๋๋ค.
- Twilio: Twilio์ ๋ฌธ์๋ ์ฌ์ฉ ํธ์์ฑ๊ณผ ํต์ API์ ๋ํ ํฌ๊ด์ ์ธ ๋ฒ์๋ก ์ ๋ช ํฉ๋๋ค. ์ฌ๋ฌ ์ธ์ด๋ก ๋ ์ฝ๋ ์ํ์ ์ ๊ณตํ๊ณ ๋ณต์กํ ๊ฐ๋ ์ ๋ํด ๋ช ํํ ์ค๋ช ์ ์ ๊ณตํฉ๋๋ค.
- Google Developers: Google์ ๋ค์ํ ๊ฐ๋ฐ์ ์ ํ ๋ฐ ์๋น์ค์ ๋ํ ๊ด๋ฒ์ํ ๋ฌธ์๋ฅผ ์ ๊ณตํฉ๋๋ค. ์ด๋ค์ ๋ฌธ์๋ ์ ์ ๋ฆฌ๋์ด ์๊ณ ์ ํํ๋ฉฐ ์ต์ ์ํ๋ฅผ ์ ์งํฉ๋๋ค.
- Mozilla Developer Network (MDN): MDN์ HTML, CSS, JavaScript๋ฅผ ํฌํจํ ์น ๊ธฐ์ ์ ๋ํ ํฌ๊ด์ ์ธ ๋ฌธ์๋ฅผ ์ ๊ณตํฉ๋๋ค. ์ด๋ค์ ๋ฌธ์๋ ๊ฐ๋ฐ์ ์ปค๋ฎค๋ํฐ์ ์ํด ์์ฑ๋๊ณ ์ ์ง๋๋ฉฐ ์ ์ธ๊ณ ์น ๊ฐ๋ฐ์์๊ฒ ๊ท์คํ ์๋ฃ์ ๋๋ค.
- Read the Docs: Sphinx๋ก ๊ตฌ์ถ๋ ๋ฌธ์๋ฅผ ํธ์คํ ํ๊ธฐ์ ์ข์ ์ฅ์์ ๋๋ค. ๋ํ ์ข์ ๋ฌธ์ ์์ฑ์ ๋ํ ์ ์ฉํ ๊ฐ์ด๋์ ์ ๋ณด๋ฅผ ์ ๊ณตํฉ๋๋ค.
์ด๋ฌํ ์์๋ฅผ ์ฐ๊ตฌํ๋ฉด ๋ฌธ์ํ ๋ชจ๋ฒ ์ฌ๋ก์ ๋ํ ๊ท์คํ ํต์ฐฐ๋ ฅ์ ์ป์ ์ ์์ต๋๋ค.
๊ฒฐ๋ก
๋ฐ์ด๋ ๋ฌธ์๋ฅผ ์์ฑํ๋ ๊ฒ์ ๊ธ๋ก๋ฒ ํ์ด ํจ๊ณผ์ ์ผ๋ก ํ์ ํ๊ณ , ์ ๊ท ๋ฉค๋ฒ๋ฅผ ์ ์ํ๊ฒ ์จ๋ณด๋ฉํ๋ฉฐ, ์ ํ๊ณผ ์๋น์ค์ ์ฑ๊ณต์ ๋ณด์ฅํ๋ ๋ฐ ํ์์ ์ ๋๋ค. ์ด ๊ฐ์ด๋์ ์ค๋ช ๋ ๋ชจ๋ฒ ์ฌ๋ก๋ฅผ ๋ฐ๋ฅด๋ฉด ์กฐ์ง์ ์ ์ธ๊ณ ์ฌ์ฉ์๊ฐ ๋ช ํํ๊ณ , ๊ฐ๊ฒฐํ๋ฉฐ, ์ ํํ๊ณ , ์ ๊ทผํ๊ธฐ ์ฌ์ด ๋ฌธ์๋ฅผ ๋ง๋ค ์ ์์ต๋๋ค. ๋ฌธ์ํ๋ ์ง์์ ์ธ ๊ด์ฌ๊ณผ ์ ์ง ๊ด๋ฆฌ๊ฐ ํ์ํ ์ง์์ ์ธ ํ๋ก์ธ์ค์์ ๊ธฐ์ตํ์ญ์์ค. ๋ฌธ์ํ๋ฅผ ์กฐ์ง์ ์ฑ๊ณต์ ๊ธฐ์ฌํ๋ ๊ท์คํ ์์ฐ์ผ๋ก ๋ฐ์๋ค์ด์ญ์์ค.
๊ณ ํ์ง ๋ฌธ์์ ๋ํ ํฌ์๋ ์ฌ์ฉ์ ๋ง์กฑ๋ ํฅ์, ์ง์ ๋น์ฉ ์ ๊ฐ, ์ ํ ํ์ง ํฅ์์ ํํ๋ก ๋ณด๋ตํฉ๋๋ค. ๋ฌธ์ํ๋ฅผ ์ฐ์ ์์์ ๋ ์ผ๋ก์จ ๊ธ๋ก๋ฒ ํ์ ํ์ ์ค์ด์ฃผ๊ณ ๋น์ฆ๋์ค ๋ชฉํ๋ฅผ ๋ฌ์ฑํ ์ ์์ต๋๋ค.