readme2 개발자 문서화 (생각 기록, 협업, 유지보수) 개발 공부를 처음 할 때 저는 코드만 잘 돌아가면 충분하다고 생각했습니다. 문서화는 시간이 남을 때 하는 부가 작업처럼 느껴졌고, README도 형식적으로 적는 정도로 봤습니다. 그런데 몇 달 뒤 제가 만든 코드를 다시 열었을 때, 왜 JWT를 선택했는지, 오류를 어떻게 해결했는지, 어떤 기준으로 구조를 잡았는지 기억나지 않아 당황했습니다. 팀 프로젝트에서도 API 명세나 실행 방법이 정리되지 않으면 같은 질문이 반복되고, 새 팀원이 적응하는 데 시간이 오래 걸렸습니다. 저는 그때 문서화가 단순한 글쓰기가 아니라 개발자의 생각과 문제 해결 과정을 남기는 일이라고 느꼈습니다. 이 글에서는 제 경험을 바탕으로 개발자가 문서화를 잘하면 얻는 장점을 정리해 보겠습니다.개발자 문서화가 내 생각을 기록하는 이유코드.. 2026. 6. 11. 신입 포트폴리오 (작은 결과물, 문제 해결 기록, 프로젝트 경험) 포트폴리오를 처음 준비할 때 저는 보여줄 만한 큰 프로젝트가 없다는 이유로 시작을 미뤘습니다. 하지만 작은 클론 코딩과 기능 구현을 GitHub에 올리고 README에 문제 해결 과정을 적어보면서 생각이 달라졌습니다. 포트폴리오는 완성된 실력만 보여주는 문서가 아니라, 배우고 막히고 해결하며 성장한 과정을 기록하는 자료였습니다. 특히 입력값 검증, API 오류, Git 충돌 같은 작은 경험도 원인과 해결 방법을 정리하면 충분히 면접에서 말할 수 있는 근거가 됐습니다. 저는 경험이 없어서 포트폴리오를 못 만드는 것이 아니라, 작은 경험을 기록하지 않아서 비어 보인다고 생각합니다. 그래서 지금 할 수 있는 기능 하나라도 만들고, 배운 점과 개선할 점까지 남기는 것이 가장 현실적인 시작이라고 느꼈습니다.작은 .. 2026. 4. 29. 이전 1 다음
