[프로젝트 트러블슈팅] 1. Code Convention Missing

문정준's avatar
Apr 24, 2025
[프로젝트 트러블슈팅] 1. Code Convention Missing
 

1. 문제 발생 배경

  • 화면의 설계 이후, 각자 화면의 제작 개수를 맞추고 비슷한 기능끼리 묶어서 작업할 수 있도록 역할을 분배하였음.
  • 코드 컨벤션에 대한 토의를 진행했으나, CSS의 경우 bootstrap을 가급적이면 사용하고, 특별한 서식을 넣어야 할 경우 만들게 될 css 시트는 페이지명의 이름을 따라가자고 정한 상태였음.
 

2. 문제 발생

  • 각자 제작을 시작하고, 화면 1차 종합을 했는데 각자 지정해 둔 스타일이 달라 화면에서 글자가 어느 곳은 깨지고, 어느 곳은 비율이 맞지 않는 문제가 발생함.
 

3. 원인 분석

  • 컨벤션을 정할 때에 스타일을 정확히 명시하지 않았음.
  • 화면 설계에 있어서도 각자 툴을 다르게 사용하고, 적용한 스타일이 다 달라서 규격, 박스 사이즈, 글꼴 등이 전부 일치하지 않아 스타일이 크게 틀어짐.
  • margin 및 화면 비율을 설정하지 않아 어떤 화면은 해상도를 줄이면 내용이 세로로 적히고, 어떤 화면은 그대로 출력되며, 어떤 화면은 크기가 너무 커서 내용이 잘려 본문을 다 불러올 수 없었음.
통일되지 않은 스타일
통일되지 않은 스타일

4. 해결법 및 피드백

  • 스타일을 적용할 때에도 컨벤션 및 기준을 적용하여, 정확한 스타일과 크기(비율)를 토의를 통해 결정하고 컨퍼런싱 페이지의 양식을 정확하게 지킬 수 있도록 예시 페이지를 팀원과 확인해가며 컨벤션을 수정 및 새롭게 결정하였음.
 
  • 단순히 함수, 파일명의 컨벤션만이 아닌 홈페이지의 스타일링, 폰트, 간격 등 세세한 부분에서도 컨벤션을 맞추어야 기대했던 결과물이 잘 나올 수 있다는 것을 체감할 수 있었음.
Share article

sxias