질문 보드 운영하기
질문 보드는 공개 Q&A입니다. 사용자가 궁금한 것을 묻고, 팀(또는 다른 사용자)이 답하고, 가장 좋은 답변을 채택 답변으로 표시합니다. 그러면 질문 페이지가 그 답변으로 시작하고, 보드는 그 질문을 답변 완료로 보여 줍니다. 아이디어 보드와 같은 종류의 보드이며, 상태와 페이지는 따로 있습니다.
1. 보드 만들기
프로젝트의 Feedback 섹션에서 Manage boards를 엽니다(보드가 없는 프로젝트는 첫 보드를 만드는 양식이 바로 열립니다). 보드 이름을 정하고 주소를 확인한 뒤 Kind에서 Questions를 고릅니다.
종류는 보드를 만들 때 정해지며 이후에는 바꿀 수 없습니다. 두 종류는 상태와 기능이 다르기 때문입니다. 마음이 바뀌면 보드를 새로 만드세요. 헬프 센터 하나에 두 종류의 보드를 함께 둘 수 있고, 사이트의 보드 목록에 모두 나타납니다.
질문 보드도 아이디어 보드처럼 비공개로 바꾸지 않으면 공개이고, 페이지는 헬프 센터 사이트의 /feedback/<board>에 있습니다. 주소, 자체 도메인, 자기 사이트의 경로 아래에서 제공하는 방법은 공개 피드백 보드 열기를 참고하세요. 사용자는 앱에서 사용자 로그인시키기에서 설명한 토큰으로 같은 방식으로 로그인합니다.
질문 보드에는 로드맵, 릴리스 정책, GitHub 링크가 없습니다. 질문은 출시되지 않기 때문입니다. 이 기능들은 질문 보드에 나타나지 않으며, 질문 보드의 로드맵 페이지 주소는 404입니다.
2. 상태
질문은 Open, Answered, Closed 중 하나입니다.
새 질문은 Open으로 시작합니다.
댓글 하나가 답변으로 채택되면 Answered가 되고, 그 답변을 취소하면 다시 Open으로 돌아갑니다.
Closed는 직접 지정합니다. 주제에서 벗어난 질문처럼 답하지 않으려는 질문에 씁니다. Answered는 직접 지정할 수 없습니다. 질문은 댓글이 답할 때만 답변 완료가 되기 때문입니다.
3. 답변 채택하기
공개 댓글이면 무엇이든 답변이 될 수 있습니다. 팀의 답글도, 다른 사용자의 답변도 됩니다. 채택할 수 있는 사람은 두 부류입니다.
팀: 콘솔에서 질문을 열고 댓글 아래의 Accept as answer를 선택합니다.
질문한 사람: 앱에서 로그인한 상태로 공개 페이지에서 채택합니다. 질문한 사람에게만 버튼이 보입니다. 자신이 묻지 않은 질문의 답변은 로그인 여부와 관계없이 다른 사용자가 채택할 수 없습니다.
질문에는 채택 답변이 하나만 있습니다. 다른 댓글을 채택하면 표시가 그 댓글로 옮겨 가고, Unaccept를 선택하면 채택이 취소되어 질문이 다시 열립니다. 내부 메모는 방문자에게 보이지 않으므로 채택할 수 없습니다. 채택된 댓글을 삭제해도 질문이 다시 열립니다.
공개 페이지에서는 채택 답변이 다른 댓글보다 앞에, 별도의 틀 안에 먼저 나옵니다.
4. 방문자에게 보이는 것
보드는 질문을 득표 수가 많은 순(Top) 또는 최신순(New)으로 나열합니다. All, Open, Answered는 목록을 필터링하고, 검색창은 질문의 제목과 본문에서 단어를 찾습니다. 필터와 검색어는 주소에 유지되므로(?status=answered&q=export) 필터링한 목록을 링크로 공유할 수 있습니다.
질문에 대한 득표는 "저도 이 질문이 궁금해요"라는 뜻입니다. 많은 사람이 공통으로 궁금해하는 질문이 위로 올라옵니다. 앱에서 로그인하지 않은 사람도 아이디어 보드처럼 이메일 주소로 투표할 수 있지만, 질문하거나 댓글을 달 수는 없습니다.
로그인한 사용자는 Ask a question으로 질문합니다. 제목을 입력하는 동안 보드가 비슷한 질문을 보여 주므로, 이미 있는 답변을 찾아볼 수 있습니다.
5. 헬프 센터 검색에 나오는 답변
프로젝트에 헬프 센터와 공개 질문 보드가 있으면, 헬프 센터 검색은 그 보드의 답변 완료 질문도 문서 옆에 Answered question 표시와 함께 보여 줍니다. 검색창 하나로 가이드와 사용자의 질문을 모두 찾을 수 있습니다. 질문은 같은 정도로 일치하는 문서보다 뒤에 나오며, 아직 답이 없는 Open 질문은 나오지 않습니다.
6. 관리하기
관리 방법은 아이디어 보드와 같습니다.
**Merge into another post…**는 중복 질문을 남길 질문에 합칩니다. 득표와 팔로워가 그쪽으로 옮겨 가고, 중복 질문의 주소는 합쳐진 질문으로 안내합니다.
댓글의 Delete는 그 댓글을 지웁니다. Delete post는 질문을 모든 댓글과 득표와 함께 지웁니다. 둘 다 먼저 확인을 묻고, 되돌릴 수 없습니다.
내부 메모는 Mocco 안에만 남고 보드에는 나타나지 않습니다.
상태 변경, 삭제, 가져오기는 모두 워크스페이스의 감사 로그에 기록됩니다.
7. CLI, API, MCP에서
위 기능은 도구에서도 쓸 수 있습니다. mocco feedback import는 다른 도구의 질문을 가져옵니다(보드의 기록 가져오기 참고). MCP에서는 mocco_feedback_board_create가 종류를 받고, mocco_feedback_comment_accept와 mocco_feedback_comment_unaccept가 답변을 채택하고 취소합니다. MCP의 모든 변경처럼 먼저 확인을 요청합니다. 공개 API로는 앱이 질문한 사용자를 대신해, 글과 투표에 쓰는 것과 같은 사용자 토큰으로 답변을 채택할 수 있습니다.