PROJECT 05 / STANDARDIZATION · DOCUMENTATION
Publishing System
개인의 작업 방식을, 팀의 공통 기준으로.
PROJECT EVIDENCE / STRUCTURE & FLOW
문서가 실제 작업 순서가 되도록.
GUIDE / 01
개발 저장소별 작업 가이드
GUIDE / 02
퍼블리싱 작업 가이드
GUIDE / 03
다국어 가이드
퍼블리싱 샘플 가이드의 실제 작업 순서
- 01수정할 SCSS 위치 확인
- 02컴파일 대상 기준 watch 실행
- 03SCSS 수정 → CSS 자동 반영
- 04반영 확인 · 문법 및 경로 오류 점검
공개용 Notion 샘플 가이드를 시각화했습니다. 실제 사내 문서와 화면은 포함하지 않았습니다.
재구성 다이어그램 — Notion 프로젝트 설명을 바탕으로 구조와 흐름을 시각화했습니다. 실제 서비스 화면이나 사내 문서 캡처가 아닙니다.
01 / BACKGROUND
어떤 프로젝트인가요?
팀 내 퍼블리싱 작업 방식과 협업 기준을 정리해 신규 인원의 온보딩과 반복 커뮤니케이션 비용을 줄이기 위한 문서화 프로젝트입니다. 개발 환경, 프로젝트 구조, 다국어 관리, 스타일 규칙 등 실제 업무에서 반복적으로 발생하던 질문과 혼선을 기준으로 가이드를 구성했습니다.
02 / CHALLENGE
무엇을 해결해야 했나요?
작업자마다 다른 방식과 반복되는 질문이, 결과물의 일관성과 팀의 시간을 함께 떨어뜨리고 있었습니다.
- 신규 인원이 저장소와 프로젝트 구조를 이해하는 데 시간이 오래 걸렸습니다.
- 작업자마다 퍼블리싱 방식과 협업 기준이 달라 결과물의 일관성이 떨어졌습니다.
- 개발 환경, 다국어 처리, 스타일 규칙과 관련한 반복 질문이 지속적으로 발생했습니다.
03 / APPROACH
어떻게 접근했나요?
- 반복 이슈와 질문 유형을 정리하고, 실제 작업 중 자주 발생하는 질문과 오류를 기준으로 문서 구조를 설계했습니다.
- 단순 규칙 나열이 아니라 프로젝트 진입부터 작업·검수까지의 흐름을 따라갈 수 있도록 내용을 구성했습니다.
- 저장소별 차이와 공통 규칙을 구분해 필요한 정보를 빠르게 찾을 수 있도록 정리했습니다.
04 / GUIDE STRUCTURE
세 갈래의 가이드
실제 내부 문서는 보안상 공개할 수 없어, 구조와 경험을 기반으로 재구성한 내용입니다.
- 개발 저장소별 작업 가이드 — 개발 환경과 저장소별 작업 방식
- 퍼블리싱 작업 가이드 — 스타일 규칙과 협업·검수 기준
- 다국어 가이드 — 다국어 리소스 관리와 처리 규칙
05 / OUTCOME
무엇이 달라졌나요?
개인의 경험으로 흩어져 있던 작업 방식을, 누구나 따라갈 수 있는 팀의 기준으로 만들었습니다.
- 신규 인원의 프로젝트 이해와 초기 작업 적응에 필요한 기준을 마련했습니다.
- 반복적인 질문과 작업 방식 차이로 발생하던 커뮤니케이션 비용을 줄였습니다.
- 팀 내 퍼블리싱 작업 기준을 문서화해 결과물의 일관성을 높였습니다.