브라이트코브의 새로운 문서 검색 서비스를 소개합니다.

브라이트코브의 문서 포털 서비스가 새롭게 개편 되었습니다. 기존 브라이트코브의 기술 문서 서비스는 사용법 및 교육 포털 사이트개발자용 API포털 사이트의 2개 문서 사이트로 구성되어 있어, 필요한 문서를 양쪽 서비스를 오가면서 링크에서 찾아와야 하는 불편함이 있었습니다. 

사용자 편의성을 개선하고자 여러 단계의 테스트와 분석을 거쳐 검색을 통한 문서 서비스를 강화해서 새로운 문서 서비스를 오픈하게 되었습니다.

새로운 문서 검색 서비스의 주소는 https://support.brightcove.com 또는 https://support.brightcove.com/ko이며 첫화면은 아래처럼 검색창, 문서사이트 소개 비디오, 서비스 User를 위한 매뉴얼 영역과 개발자를 위한 API문서 영역으로 구성되어 있습니다.

이번 새버전의 새로운 점은 기존보다 좀더 다양한 검색 이나 조건을 통해 문서를 찾아오는 기능을 강화한 것입니다. 검색창에 필요한 검색어를 입력하고 검색 버튼을 누르면 새로 개편된 검색 페이지를 보실수 있습니다. 검색 결과 화면의 좌측에는 문서 포털의 정보 카테고리를 선택하실수 있는 필터 영역과 상담의 검색영역 및 그 하단의 검색 결과로 구성됩니다. 

필터 영역은 기술문서 분류에 사용된 키워드별 문서의 총 갯수를 보여주고 있으며, 해당 필터 옵션을 선택하면 선택된 필터를 적용해서 문서를 검색 해오는 방식 입니다. 주요 필터는 아래와 같이 분류 됩니다. 

  • Product : 서비스 종류별 필터
  • Role : 문서를 검색하는 분의 비디오 퍼블리싱과 관련 역할
  • Task : 사용자가 해야 하는 행위의 종류
  • Topic : 문서에서 다루고 있는 대표적인 이슈
  • API : API의 종류별 필터
  • SDK : SDK를 사용할 플랫폼별 필터
  • Content Type : 기술문서 또는 사용법 비디오

필터의 종류

여러가지 문서 필터들은 검색 키워드의 사용 없이 특정 주제에 관련된 문서들을 빨리 찾아서 확인 할 수 있는 방법을 제공합니다. 

검색 방식

문서를 검색 하실때는 기본적으로 필터의 지정 없이 검색 키워드만 입력해서 검색할 수 있습니다. 모든 문서에 대해 다국어 서비스를 제공하지 못하고 있는 관계로, 한글로 검색해서 충분한 답변을 찾기 어려운 경우 영문 키워드로 검색 하시면 더 많은 문서를 찾을 수 있습니다.

또한 새로운 문서 포털 검색 에서는 한국어와 영어 문서들을 한 화면에서 모두 검색 하실수 있도록 서비스를 제공하고 있습니다. 

한국어 검색 결과

한국어로 번역된 결과에서 페이지를 찾아 옵니다.

영문 검색 결과

한국어 검색 결과보다 많은 검색 결과를 보실수 있습니다.

다중 필터를 통한 문서 리스팅

각 필터별로 값을 지정하면 해당 필터에 공통적으로 포함되는 문서들만 리스트업해서 보실수 있습니다.

다중필터 지정방법

다중필터 적용 결과

필터를 사용하는 방법에 따라 다양한 결과를 얻을 수 있습니다. 예를 들어 CMS API에서 비디오정보를 조회하는 API관련 문서를 조회 하는 경우에 아래와 같은 두가지 방법을 생각 해볼 수 있습니다.

첫번째 방법 : 사용하고자 하는 API를 알고 있는 경우에는 필터 하단에서 API->CMS API를 선택하고  Task->Get Video Metadata를 선택합니다. 

두번째 방법 : 정확한 API의 이름을 모르는 경우에는 Role에서 API developer를 선택하고 Task->Get Video Metadata를 선택합니다.

보면 첫번째 결과에서는 CMS api의 조회 기능만 검색된 반면 두번째 결과에서는 Playback api도 같이 검색된것을 볼 수 있습니다.

앞으로는 하나의 문서 검색 서비스를 통해서 좀더 편리하게 브라이트코브 서비스의 사용법을 찾을 수 있습니다. 만약 문서 검색 결과에서 필요하신 정보를 찾지 못하시는 경우에는 언제든지 브라이트코브의 기술지원팀으로 문의 주시기 바랍니다.