제품의 개발 상태를 있는 그대로 적는 방법
NCJK의 제품 중 하나는 정식 출시했고, 셋은 개발 중입니다. Work 페이지가 모든 제품의 개발 상태와 지원 환경을 같은 방식으로, 아직 없는 것을 약속하지 않고 적는 방법을 기록합니다.
맥락
NCJK의 네 제품은 같은 단계에 있지 않습니다. Ritubon은 정식 출시했고, Gloword, CollectionEve, GOIGOT은 개발 중입니다. CollectionEve는 처음부터 다시 만들고 있습니다. 제품 페이지는 완성된 제품의 언어로 쓰고 싶어지기 쉽습니다. 지원 플랫폼 목록, 출시 같은 버튼, 제품마다 붙은 주소처럼요.
예전의 Work 페이지는 제품마다 설명 방식도 달라서, 같은 종류의 정보가 제품에 따라 다른 자리에 다른 이름으로 놓여 있었습니다.
결정
- 개발 상태는 두 가지 말로만. 제품은 정식 출시 또는 개발 중 둘 중 하나로 표시합니다. 버전 번호나 내부 단계 이름은 우리에게는 의미가 있지만 방문자에게는 그렇지 않기 때문에 개발 상태에 붙이지 않습니다.
- 하나의 정보 체계, 하나의 순서. 모든 제품은 Work 페이지와 상세 페이지 모두에서 개발 상태를 먼저, 지원 환경을 다음에 보여줍니다. 두 정보는 하나의 데이터 파일에서 나오므로 두 곳의 내용이 어긋날 수 없습니다.
- 지원 환경은 지금 동작하는 것만. 제품을 직접 확인한 뒤에만 적습니다. Ritubon은 설치 가능한 웹 앱 매니페스트를 제공하고 서비스 워커를 등록하는 것을 확인했기 때문에 설치형 웹 앱(PWA)으로 표시합니다. 개발 중인 제품은 개발 버전이 실제로 실행되는 환경만 적습니다.
- 계획은 계획으로 표시합니다. 다음 단계는 ‘다음 단계’로 표시한 별도 목록에 두고, 지원 중인 항목 옆에 섞지 않습니다.
- 쓸 수 없는 제품에는 링크가 없습니다. 공개되지 않은 제품에는 버튼 대신 아직 공개되지 않았다는 한 문장을 둡니다.
- 들어가는 길은 하나. 이용할 수 있는 제품에는 ‘열기’ 링크 하나만 둡니다. 주소를 별도 정보로 반복하지 않습니다.
- 다시 만드는 것은 버전 업데이트가 아닙니다. CollectionEve는 ‘개발 중’으로, 지원 환경은 ‘공개 시 안내’로 표시합니다. 이전 버전의 내용을 지금도 유효한 것처럼 옮겨 오지 않았습니다.
근거
- Work 페이지와 네 개의 제품 페이지는 개발 상태, 지원 환경, 계획을 같은 데이터(사이트 코드의
products.ts)에서 읽습니다. 각 항목은 마지막으로 바꿀 때 제품과 대조해 확인했습니다. - 배포할 때마다 실제 페이지를 빌드 결과와 자동으로 비교합니다. 제품으로 가는 링크도 비교 대상이므로, 방문자가 보는 페이지는 검토한 빌드와 같습니다.
돌아보기
상태를 정직하게 적으면 어떤 페이지는 출시 페이지보다 조용해 보입니다. 그래도 방문자가 페이지에 적힌 내용을 믿을 수 있다는 점이 더 중요하다고 판단했습니다.
한계도 있습니다. 개발 상태는 코드가 아니라 실제 제품에서 바뀝니다. 제품이 다음 단계로 넘어가면 데이터 파일을 직접 고쳐야 합니다. 자동 검사는 페이지가 빌드와 같은지를 확인할 뿐, 빌드가 여전히 제품과 같은지는 확인하지 못합니다.