문서를 불러오는 중입니다.

Docs 문서 배포

Docs 문서 배포


문서 배포 개요

Docs는 좌측의 문서 구조 영역과 우측의 문서 내용 영역으로 구성됩니다. 관리자는 문서 구조 영역 상단의 배포 아이콘(image.png)을 통해 작성한 문서를 사용자에게 공개할 수 있습니다.

배포된 문서는 검색엔진의 검색 대상에 포함되며, 대화형 챗봇이 답변을 생성할 때 참조하는 자료로 활용됩니다. 따라서 사용자에게 제공할 기술문서와 안내 자료는 작성 및 검토 후 배포해야 합니다.


문서 배포 정책

관리자 관점

  • 문서 배포: 관리자가 문서를 작성한 후 배포하면, 해당 문서가 사용자 화면에 공개됩니다.
  • 배포 문서 수정 및 삭제: 배포된 문서를 수정하거나 삭제하면 변경 사항이 사용자 화면에도 반영됩니다.
  • 미배포 문서 관리: 배포 전 문서는 관리자에게만 표시되며, 일반 사용자는 해당 문서에 접근할 수 없습니다.
  • 신규 문서 추가: 배포된 문서 구조에 새로운 문서를 추가하더라도, 새로 추가한 문서는 기본적으로 미배포 상태로 등록됩니다. 사용자에게 공개하려면 별도로 배포해야 합니다.
  • 하위 문서 일괄 배포: 상위 문서를 배포할 때 하위 문서도 함께 배포할 수 있습니다. 이를 통해 관련 문서를 일괄적으로 공개할 수 있습니다.

사용자 관점

  • 관리자가 배포한 문서만 조회할 수 있습니다.
  • 관리자가 배포된 문서를 수정하거나 삭제하면 변경 사항이 사용자 화면에 반영됩니다.
  • 아직 배포되지 않은 문서는 사용자 화면에 표시되지 않으며, 조회할 수 없습니다.
  • 배포된 문서는 검색엔진 및 챗봇의 참조 자료로 활용될 수 있습니다.


문서 배포 사례

다음은 문서 작성, 배포, 추가 및 삭제 과정에서 관리자와 사용자 화면에 나타나는 차이를 설명한 예시입니다.

구분
관리자 작업
관리자 화면
사용자 화면
1. 문서 작성
문서 구조에 Helpdesk 소개를 등록하고 내용을 작성합니다.

작성한 문서와 내용이 표시됩니다.

​image.png

배포 전이므로 해당 문서가 표시되지 않습니다.
2. 상위 문서 배포
Helpdesk 소개 문서를 배포합니다. 하위 문서도 함께 배포할 수 있습니다.

배포된 문서를 확인할 수 있습니다.

​image.png

배포된 문서가 표시됩니다.

​image.png

3. 하위 문서 추가
검색 엔진 항목 아래에 새로운 문서를 추가합니다.

새 문서가 표시되며, 기본적으로 미배포 상태입니다.

​image.png

새 문서는 배포 전까지 표시되지 않습니다.

​image.png​

4. 배포 문서 삭제
배포된 Helpdesk 접수 및 처리 문서를 삭제합니다.

삭제 결과가 반영됩니다.


​image.png

삭제된 문서가 사용자 화면에서도 제거됩니다.

​image.png​

5. 상위 문서 재배포
Helpdesk 소개 문서를 다시 배포합니다.

배포 결과를 확인할 수 있습니다.


​image.png​

배포 대상에 포함된 문서가 공개됩니다.

​image.png


운영 시 유의사항

  1. 배포 전 검토: 문서 내용의 정확성, 최신성 및 공개 적절성을 확인한 후 배포합니다.
  2. 신규 문서 공개 관리: 새로 추가한 문서는 미배포 상태일 수 있으므로, 사용자에게 공개해야 하는 문서인지 확인하고 배포합니다.
  3. 수정 및 삭제 영향 확인: 배포된 문서의 수정·삭제는 사용자 화면에 영향을 주므로 변경 전 관련 내용을 검토합니다.
  4. 검색 및 챗봇 활용 고려: 문서 배포 여부는 검색엔진과 챗봇의 정보 활용에 영향을 줄 수 있으므로, 공개할 자료를 적절히 관리합니다.
  5. 하위 문서 배포 범위 확인: 상위 문서 배포 시 하위 문서가 함께 배포되는 경우, 각 하위 문서의 내용과 공개 범위를 확인합니다.

문서 배포 기능을 활용하면 관리자는 문서 작성 및 검토와 사용자 공개를 구분하여 운영할 수 있으며, 사용자는 승인된 기술자료를 기반으로 필요한 정보를 검색하고 확인할 수 있습니다.