공식문서가 어려운 이유

처음 웹 개발을 공부하기 시작할 때 mdn보다 w3school을 가게되는지…

공식문서가 어려운 이유

• 모르는 걸 모르게 설명한다
• 엄청 디테일해서 TMI다
• 엄청 생략된 예제
• 영어

모르는 걸 모르게 설명한다

• 공식 문서를 작성하시는 분들은 당연히도 그 기술에 대해 빠삭하신 분들이다
• 해당 기술을 잘 알고 있는 사람들한테는 최고의 문서일 것이다
• 하지만 초보가 문서를 읽었을 때 개발 경험 부족으로 센스가 부족해서
• 아주 간단한 것일지라도 막힐 때가 있다

• 사전에서 어떤 단어를 찾았는데 그 단어가 또다시 모르는 단어로 설명되어 있는 느낌

엄청 디테일해서 TMI다

• 나는 빨리 헬로월드를 출력하고 싶은데, 뭔가 글이 길고 복잡해 보인다
• install 할 때 여러 옵션들, cli 명령어의 여러 옵션들 등
• 실행만 하는데도 너무 어려울 것 같은 인상을 준다
• 나는 보통 스크롤이 길고 빼곡한 줄글이 있으면 탈주가 하고 싶다

엄청 생략된 예제

• 프로젝트 세팅 및 디렉터리 구조 등 생략된 것이 많이 있다
• 처음 접할 때 내가 튜토리얼을 잘 따라가고 있는지 의문이 들 때가 많이 있다
• 명령어를 실행해야 하는 디렉터리가 어디인지
• 어디에 파일을 생성해야 하는지
• 프로젝트 세팅을 어떻게 해야 하는지
• 알고 보면 너무 당연한 베이스지만 초보라면 그것조차 너무 어렵다 ㅠㅠ

영어

• 안 그래도 무슨 말인지 잘 모르는데 영어 ㅠㅠ
• 기술 용어들이 많아서 번역을 써도 이상한 경우가 많이 있다

생각

• 공식문서를 보는 게 좋다 주변에서 들었지만
• 나는 공식문서 보다가 ctrl w를 누른 적이 너무 많다
• 요즘에야 많이 익숙해지고 센스도 늘어서 공식문서를 예전보다는 많이 읽는 편이다

• 하지만 요즘도 처음 사용하는 라이브러리라든가
• 빠른 프로젝트 적용 또는 시작을 위해 youtube를 참고한다
• 영상만큼 직관적인 게 없다고 생각한다
• 정적인 문서로는 초보자를 이해시키는 게 어렵다
• 영상은 변경사항을 업데이트하기가 어려운 단점이 있다
• 영상 제작은 아무래도 노력이 많이 필요하다