본문으로 건너뛰기

문서 변경 로그 - PDF Connect v3

2026-02-21 매뉴얼 URL 블록 업데이트​

  • 새 가이드 추가: manual-url-blocks.md
  • 게시/설정/뷰어/디스플레이 문서를 업데이트하여 매뉴얼 상품 템플릿 블록을 문서화
  • 연결 방식(Linked)과 매뉴얼 방식(Manual)의 동작 차이를 더 명확히 설명
  • 매뉴얼 방식 전용 트러블슈팅 체크 항목 추가
  • 사이드바 내비게이션에 새 가이드를 포함하도록 업데이트

개요​

이 변경 로그는 PDF Connect v3 문서의 전체 개편 내역을 추적합니다. v3에서는 모든 페이지 유형에 대한 범용 페이지 연결(Universal linking), 향상된 게시 워크플로, 개선된 UI/UX가 도입되었습니다.

상태 표기​

  • ✅ 완료(Completed) - v3 기능을 반영해 업데이트되었고 새 스크린샷만 추가하면 됨
  • 🔄 진행 중(In Progress) - 현재 업데이트 중
  • ❌ 업데이트 필요(Needs Update) - v3 개편이 필요한 기존 문서
  • 📸 스크린샷 필요(Needs Screenshots) - 내용은 업데이트되었고 새 이미지가 필요함

업데이트된 파일(v3)​

핵심 가이드 - 완료 ✅​

intro-v3.md ✅​

  • 상태: 완료, 스크린샷 필요
  • 변경 사항:
    • 3가지 표시 방식(임베디드 PDF, PDF 버튼, PDF 목록)을 설명하도록 업데이트
    • 범용 연결 기능 추가(모든 페이지 유형)
    • 간소화된 2단계 게시 워크플로를 강조
    • 성공 사례와 비즈니스 가치 제안 추가
  • 기존 파일: intro.md → intro-old.md
  • 필요 스크린샷: SCREENSHOT_REQUIREMENTS.md에 핵심 스크린샷 8개 정의

tutorial-basics/link-pdfs-v3.md ✅​

  • 상태: 완료, 스크린샷 필요
  • 변경 사항:
    • 범용 연결(모든 페이지 유형)을 기준으로 전체 재작성
    • 검색/페이지네이션/일괄 선택 기능 강화
    • 페이지 간 연결 전략과 트러블슈팅 추가
    • 스크린샷 플레이스홀더를 필요한 위치에 배치
  • 기존 파일: tutorial-basics/link-pdfs.md → tutorial-basics/link-pdfs-old.md
  • 필요 스크린샷: 핵심 스크린샷 12개 정의

tutorial-basics/place-linked-pdf-v3.md ✅​

  • 상태: 완료, 스크린샷 필요
  • 변경 사항:
    • 새로운 게시 모달 시스템을 반영하도록 업데이트
    • 3가지 표시 방식과 구체적인 사용 사례 추가
    • 템플릿 선택 및 멀티 블록 전략 강화
    • 성능 최적화 및 트러블슈팅 섹션 추가
  • 기존 파일: tutorial-basics/place-linked-pdf.md → tutorial-basics/place-linked-pdf-old.md
  • 필요 스크린샷: 핵심 스크린샷 15개 정의

publishing-workflow-v3.md ✅​

  • 상태: 새 파일, 완료, 스크린샷 필요
  • 목적: 새 게시 시스템을 위한 종합 워크플로 가이드
  • 내용:
    • 상세한 베스트 프랙티스 및 트러블슈팅
    • 템플릿 관리 전략
    • 성능 및 UX 최적화
  • 필요 스크린샷: 워크플로 전용 스크린샷 8개 정의

업데이트가 필요한 파일 ❌​

튜토리얼 기본​

  • tutorial-basics/upload-a-pdf.md ❌ - v3 UI 업데이트 필요
  • tutorial-basics/account-and-subscription.md ❌ - 변경 사항이 거의 없을 가능성
  • tutorial-basics/paste-pdf-id.md ❌ - 레거시 기능일 수 있음
  • tutorial-basics/place-non-prd-page.md ❌ - 범용 연결로 대체됨
  • tutorial-basics/place-linked-pdf-legacy.md ❌ - 레거시 방식(아카이브 후보)

튜토리얼 추가​

  • tutorial-extras/link-pdfs-bulk.md ❌ - v3 일괄 UI 업데이트 필요
  • tutorial-extras/external-pdfs.md ❌ - v3 인터페이스 업데이트 필요
  • tutorial-extras/pdf-viewers.md ❌ - v3 뷰어 옵션 반영 필요
  • tutorial-extras/using-tags.md ❌ - v3 태그 UI 반영 필요
  • tutorial-extras/translate-your-site.md ❌ - 변경 사항이 거의 없을 가능성

레거시 섹션​

  • legacy/button-designer.md ❌ - 테마 편집기 블록으로 대체됨
  • legacy/pdf-placement.md ❌ - 게시 워크플로로 대체됨

스크린샷 요구사항​

우선순위 1 - 핵심 워크플로 📸​

  1. 앱 개요: 메인 PDF 관리 화면
  2. 연결 인터페이스: 새 페이지 유형 드롭다운 및 선택 흐름
  3. 게시 모달: 3가지 표시 방식 옵션
  4. 테마 편집기: 템플릿에 PDF 블록을 추가하는 과정
  5. 리소스 선택: 검색과 페이지네이션 동작 예시

우선순위 2 - 고급 기능 📸​

  1. 멀티 블록 템플릿: 같은 페이지에 다른 스타일을 함께 사용하는 예시
  2. 일괄 작업: 스프레드시트 가져오기(Import) 인터페이스
  3. 설정 및 커스터마이징: 블록 구성 옵션
  4. 모바일 화면: 모바일에서 PDF가 표시되는 방식
  5. 성능 도구: 분석 및 최적화 기능

우선순위 3 - 사용 사례 📸​

  1. 상품 매뉴얼 예시: 상품 페이지에 임베디드 PDF
  2. 컬렉션 카탈로그: 컬렉션 페이지에 PDF 목록
  3. 블로그 리소스: 게시글(Article) 페이지에 PDF 버튼
  4. 홈페이지 기능: 인덱스 페이지에 PDF 통합
  5. 오류 상태: 문제가 발생했을 때 사용자에게 보이는 화면

스크린샷 촬영 세션 메모​

캡처해야 할 UI 요소​

  • 새 드롭다운 메뉴 및 선택 인터페이스
  • 개선된 UX를 반영한 모달
  • 테마 편집기 연동 지점
  • 모바일 반응형 화면
  • 오류 및 로딩 상태

준비해야 할 콘텐츠 예시​

  • 현실적인 이름/설명이 포함된 샘플 PDF
  • 테스트용 상품/컬렉션/게시글/페이지
  • 다양한 PDF 크기와 유형
  • 모바일 디바이스 테스트 환경

전/후 비교​

  • 기존 연결 인터페이스 vs 신규 연결 인터페이스
  • 레거시 배치 방식 vs 테마 편집기 블록
  • 상품 전용 연결 vs 범용 연결
  • 단일 표시 방식 vs 다중 표시 방식

마이그레이션 전략​

1단계: 핵심 문서 ✅​

  • 메인 워크플로 가이드 업데이트
  • 종합 기능 문서 작성
  • 새 파일 네이밍 규칙 확립

2단계: 상세 가이드 🔄​

  • 업로드/계정 가이드 업데이트
  • 일괄 작업 문서 개편
  • 외부 PDF 및 뷰어 가이드 업데이트

3단계: 레거시 관리 📋​

  • 대체된 기능 아카이브
  • 기존 사용자용 마이그레이션 가이드 작성
  • 내비게이션 및 상호 참조 링크 업데이트

4단계: 시각 자료 강화 📸​

  • 스크린샷 촬영 세션 일정 조율
  • 모든 플레이스홀더 이미지를 실제 이미지로 교체
  • 복잡한 워크플로용 비디오 튜토리얼 추가
  • 실제 머천트 환경에서 문서 테스트

문서 개편 시스템 구축 완료 ✅​

파일 관리 전략​

  • 네이밍 규칙: 새 파일은 식별을 쉽게 하기 위해 -v3 접미사를 사용
  • 기존 파일 보존: 원본 파일은 참고용으로 -old 접미사로 리네임
  • 변경 이력 추적: 상태 업데이트 및 스크린샷 요구사항을 포함한 전체 변경 로그 유지

이미지 관리 전략​

  • 기존 이미지 제거: 오래된 스크린샷은 문서에서 모두 제거
  • 전략적 플레이스홀더: 시각 자료가 도움이 되는 위치에 [SCREENSHOT NEEDED: Description] 배치
  • 요구사항 문서화: 별도 파일로 스크린샷 요구사항을 종합 정리
  • 우선순위 시스템: 3단계 우선순위로 촬영 범위를 관리

품질 보증(QA) 프로세스​

  • 콘텐츠 리뷰: 모든 v3 파일을 정확성/완성도 기준으로 검토
  • 링크 검증: 내부 링크를 v3 버전으로 업데이트
  • 일관성 점검: 문서 전반의 포맷과 용어를 통일
  • 접근성: 대체 텍스트(alt) 요구사항 및 설명형 플레이스홀더 계획

개편 완료된 파일​

핵심 문서 ✅​

  1. intro-v3.md - v3 기능을 포함한 메인 소개
  2. tutorial-basics/link-pdfs-v3.md - 범용 연결 가이드
  3. tutorial-basics/place-linked-pdf-v3.md - 향상된 게시 가이드
  4. publishing-workflow-v3.md - 종합 워크플로 가이드

보조 문서 ✅​

  1. DOCUMENTATION_CHANGELOG.md - 변경 추적 및 상태
  2. SCREENSHOT_REQUIREMENTS.md - 시각 자료 계획

다음 단계 파일(예정)​

  • getting-started-v3.md - 현대적인 온보딩 가이드
  • advanced-features-v3.md - 파워 유저 기능
  • tutorial-basics/upload-a-pdf-v3.md - 업데이트된 업로드 프로세스
  • tutorial-extras/link-pdfs-bulk-v3.md - 향상된 일괄 작업

이 체계적인 접근으로 다음을 보장합니다.

  • 콘텐츠 유실 없음: 모든 원본 콘텐츠를 그대로 보존
  • Clear Progress Tracking: Easy to see what's done vs. what needs work
  • Professional Quality: Consistent, modern documentation standards
  • Future-Ready: Scalable system for ongoing updates

Success Metrics​

Documentation Quality:​

  • All v3 features documented comprehensively
  • Clear migration path from v2 to v3
  • Reduced support tickets about new features
  • Positive merchant feedback on clarity

Visual Enhancement:​

  • Modern screenshots reflecting current UI
  • Consistent visual language across all guides
  • Mobile-optimized documentation experience
  • Video supplements for complex workflows

This renovation will ensure our documentation matches the quality and sophistication of the new PDF Connect v3 features.