서비스 화면이 바뀌었을 때 이용자는 그 이유를 어디서 확인할 수 있을까? 예를 들어 익숙한 목록의 모양이 달라졌다면, 설정을 바꿀 수 있게 된 것인지 일시적인 오류인지 바로 알기 어렵다. 새 기능을 배포해도 그 용도와 사용 가능한 범위를 설명할 자리가 필요하다.

9월 2일 공개한 뮤즈캣 Beta에서는 검색과 지역 필터, 목록 표시 설정을 변경했다. 이 내용을 서비스 안의 업데이트 문서로 남기고 홈에서 찾아갈 수 있도록 했다.

서비스 변경을 설명하는 게시물

외부 커뮤니티에 소식을 쓰면 그곳을 읽는 사람에게는 전달할 수 있다. 하지만 오락실을 찾으려고 사이트에 들어온 이용자가 같은 글을 보리라고 기대하기는 어렵다. 홈에 짧은 안내를 두는 것만으로는 기능의 적용 범위와 준비 중인 내용까지 설명하기도 어렵다.

그래서 한 번의 발표를 주소가 있는 게시물로 다루기로 했다. 처음 방문할 때는 요약을 보고, 필요할 때 본문을 읽거나 다른 사람에게 같은 주소를 보낼 수 있는 형태다.

게시물의 요약과 본문

게시물에는 제목과 짧은 설명, 본문과 이미지를 묶어 저장한다. 공지인지 업데이트인지도 구분한다. 제목과 설명은 목록에서 읽을 글을 고르는 데 쓰고, 본문은 선택한 내용의 배경과 변경 사항을 풀어 설명한다.

홈과 상세에 같은 설명을 두 번 작성하면 수정할 때 한쪽만 바뀔 수 있다. 하나의 게시물에서 요약과 본문을 가져오면 이런 중복 작성을 줄일 수 있다. 오락실 정보 편집과는 별도의 읽기 기능으로 구성했다.

flowchart TD
    accTitle: 공식 게시물과 두 가지 읽기 화면
    accDescr: 운영자가 발행한 게시물의 제목과 설명은 요약에 쓰이고 본문과 이미지는 같은 게시물의 상세 화면에 쓰인다.
    A[운영자가 작성한 게시물] --> B[제목과 짧은 설명]
    A --> C[본문과 이미지]
    B --> D[홈의 소식 요약]
    C --> E[게시물 상세]
    D -->|게시물 ID로 이동| E

홈에서 상세 문서까지의 조회

홈은 최근 게시물의 ID와 분류, 제목, 설명, 작성 시각을 가져와 작성 시각 순으로 보여준다. ID는 게시물 하나를 식별하는 값이며, 요약에서 상세로 이동할 때 같은 글을 찾는 데 사용한다. 목록에 본문 전체를 내려받지 않아도 읽을 글을 고를 수 있다.

상세에서는 주소에 담긴 ID로 한 건을 조회하고 본문과 이미지를 표시한다. 이미지는 저장한 파일이나 지정한 주소에서 불러온다. 제목과 설명은 브라우저 제목과 공유 메타데이터에도 사용한다. 링크를 받은 사람도 어떤 변경에 관한 글인지 확인한 뒤 같은 안내를 읽을 수 있다.

2023-12-25 Beta 코드 재현 · 합성 예시 공지. 당시 문서 컴포넌트와 번들 표지 이미지를 사용했다.

sequenceDiagram
    accTitle: 요약에서 공식 안내 본문까지
    accDescr: 홈은 게시물 요약을 조회하고, 이용자가 글을 고르면 해당 ID로 본문을 읽어 제목과 설명 및 내용을 표시한다.
    participant U as 이용자
    participant W as 웹 화면
    participant D as 게시물 저장소
    W->>D: 공지와 업데이트 요약 조회
    D-->>W: ID·제목·설명·작성 시각
    U->>W: 게시물 선택
    W->>D: 선택한 ID의 게시물 조회
    D-->>W: 본문과 이미지
    W-->>U: 공식 안내 문서

업데이트 문서의 활용과 관리

Beta 발표에는 검색과 필터, 목록 설정의 변경뿐 아니라 앞으로 보완할 내용도 함께 담았다. 이용자에게는 현재 할 수 있는 일과 아직 준비 중인 일이 구분돼야 하므로, 게시물을 작성하는 과정에서도 이 차이를 분명히 적어야 한다.

홈 요약은 모든 발표를 보여주거나 읽음 여부를 확인하는 기능은 아니다. 요약과 공유 주소가 같은 상세로 이어지도록 해, 필요할 때 안내를 다시 찾는 통로를 마련했다. 발행한 뒤 본문과 이미지, 링크가 계속 유효한지 살피는 일은 운영에 남는다.

같은 Beta 원본의 본문 화면. 제목·요약·HTML 본문을 나눠 보여주며 공지 내용은 촬영용 샘플이다.

flowchart LR
    accTitle: 한 발표를 여러 경로에서 읽기
    accDescr: 홈의 요약과 공유한 주소가 같은 게시물 본문으로 이어져 설명을 각각 복제하지 않고 재사용한다.
    H[홈의 요약] --> P[같은 게시물 본문]
    L[공유한 주소] --> P
    P --> R[변경 내용과 준비 중인 내용 확인]

관련 발표: 뮤즈캣 Beta 업데이트

관련 업데이트

• 뮤즈캣 δ6 업데이트