웹 개발을 처음 배우면 블로그 글이나 영상 강의로 시작하는 경우가 많습니다. 그런데 조금만 지나면 강의에서 다루지 않은 속성이나 함수가 튀어나오고, 결국 공식 문서를 열어야 하는 순간이 옵니다. 문제는 공식 문서가 처음 보는 사람에게 꽤 딱딱하다는 점입니다. 용어가 낯설고 정보가 빽빽해서 어디부터 읽어야 할지 모르겠다는 말을 자주 듣습니다. 여기서는 문서를 덜 헤매며 쓰는 순서를 단락별로 정리했습니다.
먼저 검색하는 방법부터 바꿔 보면 좋습니다. 검색창에 막연히 "버튼 가운데 정렬"이라고 치면 수많은 개인 블로그가 먼저 나옵니다. 대신 속성 이름이나 함수 이름을 그대로 넣고 뒤에 문서 사이트 이름을 붙이면 원하는 페이지로 곧장 들어갈 수 있습니다. 대표적으로 모질라에서 운영하는 MDN Web Docs는 HTML, CSS, 자바스크립트를 폭넓게 다루고 한국어 번역 문서도 제공합니다. 번역이 최신이 아닐 때도 있으니 내용이 이상하면 화면의 언어 설정을 영어로 바꿔 원문과 비교해 보세요.
문서 페이지를 열었다면 맨 위 요약 한두 문장만 먼저 읽습니다. 이 부분에 그 기능이 무엇을 하는지가 압축되어 있습니다. 그다음 바로 아래 구문이나 문법 예시를 보고, 괄호 안에 어떤 값이 들어가는지 확인합니다. 처음부터 끝까지 정독하려고 하면 지치기 쉬우니, 요약과 구문, 예제 세 부분만 먼저 보고 나머지는 필요할 때 돌아와 읽는다는 마음으로 접근하는 편이 낫습니다.
문서마다 반복해서 나오는 표기 규칙도 알아 두면 읽는 속도가 빨라집니다. 대괄호로 묶인 값은 생략할 수 있다는 뜻인 경우가 많고, 기울어진 글씨로 쓴 단어는 실제 값으로 바꿔 넣어야 하는 자리라는 뜻입니다. 이런 약속을 처음 한 번만 익혀 두면 다른 기능의 문서를 볼 때도 같은 방식으로 읽을 수 있어서, 문서가 점점 덜 낯설게 느껴집니다.

예제 코드는 읽기만 하지 말고 꼭 직접 실행해 봐야 합니다. 눈으로만 보면 이해한 것 같아도 막상 내 코드에 옮기면 동작하지 않는 경우가 많습니다. 많은 문서가 페이지 안에서 바로 결과를 볼 수 있는 실습 창을 제공하는데, 값을 하나씩 바꿔 가며 화면이 어떻게 달라지는지 확인하면 설명 글보다 훨씬 빨리 이해됩니다. 실습 창이 없다면 내 컴퓨터의 빈 HTML 파일에 붙여 넣고 브라우저로 열어 봐도 충분합니다. 브라우저의 개발자 도구를 함께 열어 두면 오류 메시지가 바로 보이는데, 이 오류 문장을 그대로 복사해 문서나 검색창에 넣는 것도 문제를 빨리 푸는 요령입니다. 오류 메시지에는 몇 번째 줄에서 문제가 생겼는지까지 적혀 있으니 그 줄부터 차근차근 살펴보세요.
그다음 눈여겨볼 곳은 브라우저 호환성 표입니다. 문서 아래쪽에는 크롬, 사파리, 파이어폭스 같은 브라우저별로 그 기능을 언제부터 지원하는지 정리한 표가 있습니다. 새로 나온 기능일수록 일부 브라우저에서 동작하지 않을 수 있으니, 실제 서비스에 쓰기 전에는 이 표를 확인하는 습관이 필요합니다.
표에서 초록색은 지원, 빨간색은 미지원, 노란색이나 별도 표시는 일부만 지원하거나 접두어가 필요하다는 뜻으로 쓰이는 경우가 많습니다. 각 칸을 누르면 세부 설명이 펼쳐지기도 하니, 애매한 표시가 있으면 한 번 눌러서 조건을 확인해 보세요. 특히 휴대폰 사파리에서 화면이 깨진다는 문의를 받았다면 가장 먼저 이 부분을 보세요.
문서 안의 관련 항목 링크도 적극적으로 따라가 보세요. 하나의 속성을 이해하려면 그와 짝을 이루는 다른 속성을 알아야 하는 경우가 많고, 문서는 이런 연결을 페이지 하단에 모아 둡니다. 다만 링크를 따라가다 처음 목적을 잊어버리기 쉬우니, 브라우저 탭을 서너 개 이상 열지 않는 정도로 선을 정해 두면 좋습니다.
문서에 "지원 중단" 또는 "더 이상 권장하지 않음" 같은 표시가 붙은 기능도 눈여겨봐야 합니다. 오래된 블로그 글에서 배운 코드가 이런 기능을 쓰고 있다면 지금은 대체 방법이 있다는 뜻입니다. 문서에 안내된 대체 기능으로 바꿔 두면 나중에 브라우저가 업데이트되어도 화면이 깨질 걱정이 줄어듭니다. 실험적 기능 표시가 붙은 항목은 연습용으로만 써 보고 실제 서비스에는 넣지 않는 편이 안전합니다.
공식 문서 외에도 자주 쓰는 개발 도구와 참고 사이트가 점점 늘어날 텐데, 이럴 때는 웹개발 링크모아처럼 분야별로 공식 주소를 정리해 둔 페이지를 북마크해 두면 검색 결과의 광고나 복사 사이트를 거치지 않아도 됩니다. 브라우저 즐겨찾기에 직접 링크모음 폴더를 만들고 문서, 색상 도구, 아이콘 사이트처럼 용도별로 나눠 두는 것도 좋은 방법입니다.
혼자 문서를 읽는 것이 아직 버겁다면 기초를 체계적으로 다뤄 주는 강의와 함께 보는 것도 괜찮습니다. 강의에서 개념을 잡고, 막히는 부분만 문서로 확인하는 식으로 역할을 나누면 부담이 줄어듭니다. 무료로 공개된 학습 사이트나 교육 플랫폼은 코딩교육 분야 모음에서 한꺼번에 비교해 볼 수 있습니다.
마지막으로, 문서에서 찾은 내용은 짧게라도 나만의 메모로 남겨 두세요. 같은 속성을 몇 달 뒤 다시 찾게 되는 일이 생각보다 많습니다. 메모장에 문서 주소와 한 줄 요약을 적어 두면 그 자체가 개인용 주소모음이 됩니다. 여러 분야를 다룬 주소모아 사이트나 사이트모음 페이지와 함께 쓰면, 필요한 정보를 찾는 시간이 눈에 띄게 줄어듭니다.
