7 단계로 (더 나은) 릴리스 노트를 작성하는 방법-IT산업-php.cn

How to Write (Better) Release Notes in 7 Steps

7 단계로 (더 나은) 릴리스 노트를 작성하는 방법 키 테이크 아웃

대상 고객과 릴리스 노트를 읽는 이유를 이해하십시오. 이것은 음표의 톤, 내용 및 프레젠테이션을 안내합니다.

독자가 알아야 할 사항과 정보에 대한 액세스가 필요한시기를 고려하여 현재 릴리스의 변경 사항을 명확하게 문서화하십시오. 릴리스 노트에 포함 할 내용을 결정하고, 인식 된 중요성 또는 복잡성에 따라 각 항목의 커버리지 깊이의 균형을 맞추십시오. 다른 사용자 세그먼트에 새로운 제품 기능을 강조하기 위해 블로그 게시물이나 이메일과 같은 다른 커뮤니케이션의 기초로 잘 작성된 릴리스 노트를 사용하십시오.

일부 비즈니스의 경우 릴리스 노트가 제품 향상이 고객에게 전달되는 유일한 방법입니다. 다른 사람들에게는 사용자 통신과 완전히 별도로 개발 된 부업입니다.

그러나 더 많은 작업을 수행하고 싶다면 (더 많은 작업을 수행하지 않고도 고객 유지 커뮤니케이션을 개선하려면 릴리스 노트는 예상치 못한 대답이 될 수 있습니다. 특히 잘 끝났다면.

> 릴리스 노트는 새로운 기능, 기능 향상 및 버그 수정을 문서화합니다. 그들은 일반적으로 간결하고 상당히 직접적이며 자연스럽게 제품에 대한 친숙한 수준을 가정합니다. 내가 아래에 설명 된 프로세스를 통해 비즈니스 및 고객이 필요로하는 제품에 대한 양질의 릴리스 노트를 쉽게 만들 수 있습니다.

그러나 원하는 경우이 프로세스는 이메일이나 블로그 게시물 또는 기능 투어와 같은 다른 릴리스 커뮤니케이션을위한 견고한 사료를 제공하여 고객에게 제공하는 내용을 개선하는 데 얼마나 커밋 된지를 상기시켜줍니다. 그리고 우리 모두가 선택을하고 서비스에 가입 한 후에도 우리가 사랑 받고 있다는 것을 알고 싶어합니다.

. 이것이 당신에게 어떻게 효과가 있는지 보자

1. 대상 고객과 메모의 목적을 명확하게하십시오. 누가 릴리스 노트를 읽습니까? 일부 제품의 경우 대다수의 사용자가 각 릴리스 메모를 확인합니다. 다른 사람들에게는 기본 사용자 기반의 매우 선택된 특정 하위 집합입니다.

릴리스 노트를 작성하는 사람을 알면 메모를 읽는 이유를 이해할 수 있습니다. 그리고 그것은 다음 단계를 추진합니다.

내가 작업하는 제품에 대한 릴리스 노트는 누구나 읽지 않고 주요 클라이언트 계정 내에서 매우 적은 비율의 사용자가 읽습니다. 릴리스 노트를 읽는 데 매우 구체적인 이유가 있습니다. 일부는 계속 업데이트 해야하는 내부 문서가 있습니다. 그러나 일부 제품의 경우 릴리스 노트는 마케팅 스핀을 피하고 싶은 많은 사용자가 읽습니다. 이와 같은 지식은 당신이 포함하는 것을 알리고 배제하는 것을 알리는 것이 아니라, 메모를 작성하는 톤과 제시 방법에 영향을 줄 수 있습니다.

2. 그들이 알아야 할 것이 무엇인지 알아보십시오

릴리스 노트는 일반적으로 제품의 현재 릴리스에서 어떤 변화가 있었는지 문서화 할 것으로 예상됩니다. 분명히, 당신은 독자들이 알아야 할

you

에 대한 아이디어를 얻게 될 것입니다. . 그러나 독자들이 알아야 할 느끼는 것에 대해 생각하는 것도 중요합니다. 예를 들어, 우리는 버그 수정을보고하거나 눈에 띄는 사람이 버그를 목록에서 식별하고 고정되어 있음을 알 수 있도록 버그 수정을 문서화합니다. 그러나 우리는 모든 버그 수정에 깊이 들어 가지 않습니다. 왜냐하면 아무도 그 모든 정보를 읽을 필요가 없기 때문에 (또는 정직한 원한다). 이 시점에서 독자가 릴리스 노트에 액세스해야 할 때 고려해야 할 것이 좋습니다. 석방 당일? 일주일 전에 검토 할 시간이 있습니까? 이렇게하면 실제로 릴리스를 구축하고 배포하는 작업에 대한 릴리스 노트 작성을 예약하는 데 도움이됩니다. 3. 이 릴리스에서 수행 한 작업을 식별하십시오 그것은 충분히 간단하게 들리지만,이 단계를 위해 좋은 프로세스를 마련하면 각 릴리스 노트의 생성을 부드럽게 할 것입니다.

. 예를 들어, 의 경우, 개발자와 제품 소유자가 최종적으로 작업이 완료된대로 점진적으로 업데이트 될 수 있다는 공유 문서를 갖기로 결정할 수 있습니다. 이로 인해 서두르기로 메모를 컴파일하려고 할 수 있습니다. 당신은 또한 해당 문서를 일반적으로 수행하는 작업의 종류, 즉 새로운 기능, 기존 기능에 대한 향상 및 버그 수정을 반영하는 섹션으로 나눌 수도 있습니다. 이렇게하면 릴리스의 모든 것이 문서에 포함되어 있는지 쉽게 볼 수 있습니다. 는 또한 단순히 구조화되지 않은 새로운 물건 목록을 가지고있는 것보다 릴리스 노트 자체를 쉽게 구성 할 수있게 해줄 것입니다.

4. 포함해야 할 내용을 결정하십시오 릴리스 노트 문서에 정보를 제공 할 때 DEVS 및 제품 소유자는 최종 사용자에 대해 생각하지 않을 것입니다. 따라서 릴리스 노트를 준비 할 때 어떤 정보를 포함 해야하는지, 생략 할 수있는 어떤 정보를 얻어야합니다.

나는 위에서 언급 한 버그 수정에 대해 특히 생각하고 있지만, 다른 사람들의 얇은 기여와 메모에 대한 일부 기여의 균형을 맞추어야 할 수도 있습니다.

다른 것보다 하나의 기능 또는 향상에 대한 더 많은 단어, 스크린 샷 및 세부 사항은 일반적으로 해당 항목의 상대적 중요성 또는 복잡성을 반영하기 위해 사용되므로 각 항목을 얼마나 깊이 덮을 지 명심하십시오. 목록.

5.

가 필요한 경우 스토리 라인이나 메시지를 작성하십시오. 항상 필요한 것은 아니지만 때로는 스토리 라인이 개선을 맥락에 넣는 데 도움이 될 수 있습니다. 나는 여기에 그것을 위해 단어를 추가하거나 멋진 간결한 릴리스 노트를 마케팅 도구로 바꾸는 것에 대해 이야기하지 않습니다. 내 말은 정보를 제시하는 순서는 사용자가 변경 사항을 이해하는 데 도움이 될 수 있다는 것입니다. 그러니 생각해보십시오. 예를 들어, 내가 준비한 최근의 릴리스 노트는 제품에 대한 안면 성형 수단과 주요 기능 추가에 대해 언급했습니다. 안면 성형에는 단순히 미용적인 변화가 수반되었으며 인터페이스의 항목 위치의 기능에 영향을 미치지 않았습니다. 기능 추가는 훨씬 더 큰 작업으로 사용자에게 장기적인 영향이 더 커졌습니다. 먼저 무엇을 덮을 수 있습니까? 우리는 FACELIFT를 사용하여 개방하기로 결정했습니다. 왜냐하면 사용자는 다음에 소프트웨어를 사용할 때 먼저 알아 차릴 것입니다. 새로운 기능은 그 후에 나열되었지만 더 많은 스크린 샷과 세부 사항이 포함되어 있습니다. 이것이 의미가있는 이유 중 하나는 새로운 기능이 앱의 나머지 부분과 크게 다르게 보였기 때문에 시각적 새로 고침의 맥락에 넣으면 그 사실에 대한 더 많은 토론을 건너 뛸 수있었습니다.

6. 메모를 작성하십시오 대부분의 사용자는 릴리스가 직접적이고 간결 할 것으로 예상합니다. 그들은 사실을 얻기 위해 거기에 있습니다. 즉, 대상 고객의 관점에서 각 기능을 해석하거나 수정하는 것이 가장 좋습니다. 그들에게 무엇을 의미합니까?

예를 들어 앱 변경을 통해 지원 직원이 엔터프라이즈 클라이언트를위한 추가 사용자 계정을 쉽게 설정할 수 있습니다. 릴리스 노트 사용자에게 의미하는 바는 다음과 같습니다. 해당 고객과 함께 신규 직원이 회사 계정에 액세스 할 수 있습니다. 그러니 그 용어로 넣으십시오.

7. 다른 커뮤니케이션에 필요한 것을 용도 변경합니다 계획이 잘 계획되고 쓰여진 경우 릴리스 노트는 다른 사용자 청중 세그먼트를 향한 다른 커뮤니케이션의 스프링 보드 역할을하여 제품의 새로운 것을 강조 할 수 있습니다. 일단 릴리스 노트를 정리 한 후에는 인앱 알림 또는 투어로 재구성 할 수있는 내용을 확인하고 도움말 컨텐츠를 검토하고 블로그 게시물, 뉴스 레터 항목 및 용도 및 개발에 사용될 수있는 것을 쉽게 알 수 있어야합니다. 다른 보유 함량. 릴리스 노트를 어떻게 개발합니까? 그건 그게 다릅니다. 어려운 절차는 아닙니다. 생산 프로세스에 많은 움직이는 부품이 있다면 릴리스 노트가 일부 작업을 수행 할 수 있습니다. . 그러나 좋은 릴리스 노트를 제작한다면, 당신은 그들에게 넣은 작업에서 훨씬 더 많은 것을 얻을 수 있습니다. 그들은 릴리스 노트를 읽을 수있는 것보다 더 광범위한 청중의 변화에 대해 의사 소통 할 때 실제 헤드 스타트를 줄 수 있습니다.

릴리스 노트를 작성하는 프로세스가 있습니까? 그리고 그들은 고객 유지 노력에 참여합니까? 의견에서 어떻게하는지 듣고 싶습니다.

더 나은 릴리스 노트를 작성하는 것에 대해 자주 묻는 질문

효과적인 릴리스 노트에 포함시킬 주요 요소는 무엇입니까?