Lorawan-stack: 질문에 대한 문제 템플릿

따라서 "조치"는 이 문제를 참조하는 문서를 직접 업데이트하고(유일한 변경인 경우) 버그 수정/기능 요청이 발생하면 다른 문서를 여는 것입니다.

정확히. "질문" 문제의 결과는 일반적으로 설명서의 변경 또는 FAQ에 추가된 것이어야 합니다.

"질문" 문제를 "버그 보고" 문제에 복사하여 붙여넣는 것이 의미가 있는지 모르겠습니다. 질문을 버그 보고서나 기능으로 전환하기로 결정했다면 댓글에 관련 섹션을 추가(또는 문제 편집)해야 할 수도 있습니다.

동의하지만 이는 포럼과 slack에도 적용되어야 합니다.

본질적으로 모든 정보는 repo 문서에 있어야 합니다. 일부 정보가 포럼, 문제 또는 여유에 대한 참조인 경우 문서를 만드는 데 실패했습니다.
slack에서 제기된 질문이나 문제, 포럼은 정보를 찾기 위한 노력을 기울이지 않는 한 문서의 변경 사항을 보완해야 합니다.

"거기 보셨나요?" 목록 대신 github/doc(검색이 impl인 경우)에 대한 쿼리에 대한 링크를 추가합니다. github 문제에서 정보를 찾는 것은 지루할 수 있으며 포럼은 문서에 없는 정보/설명을 보유하지 않아야 합니다. 이미 설정된 쿼리(예: 버그 찾기)에 대한 링크가 도움이 될 것입니다. 문서에 알려진 버그 섹션을 추가하는 것도 생각할 수 있습니다.

질문이 버그에 대한 정보를 제공하는 경우 해당 질문을 버그로 규정하고(및 버그 보고서로 문제를 편집) 질문의 유일한 부분에 버그가 포함된 경우 다른 문제를 여는 것은 개발자에게 달려 있습니다.

포럼과 Slack을 더 잘 모니터링하고 (좋은) 질문을 문서 개선으로 전환해야 한다는 데 전적으로 동의합니다(적어도 v3 카테고리 및 lorawan-stack 채널의 경우 ). @Sypheos 실제로 작동하는 보십니까 ?

"여기를 보았습니까?"의 목표는 검색을 하기 전에 문제를 제출하는 사람들을 위한 필터에 가깝습니다. 다음 섹션이 더 유용합니다. 여기에서 문제 제출자에게 관련 포럼 게시물, 여유 메시지 등에 대한 링크(또는 인용)를 요청할 수 있습니다.

좋은 아이디어라고 생각합니다. 이 문제의 범위를 유지하고 문제 템플릿을 실제로 새로운 질문으로 유지합시다.

문서 개선에 관해서는, 예를 들어 포럼과 Slack에서 문서의 일부를 원하는 비공식 답변의 경우, 최소한의 추가 "문서 요청" 문제 템플릿을 고려할 수 있습니다. 기본적으로 문서 격차와 정보가 있는 경우 현재 위치에 대한 링크(예: 포럼/Slack 메시지에 대한 링크)를 설명합니다. 그러나 다시 말하지만, 이 문제의 범위를 벗어났습니다.

질문 템플릿의 경우:
무엇을 찾고 있습니까?
어디 봤어?
_웹페이지 추가, 문제, github에 대한 쿼리, 문서, 포럼 환영_
왜 만족하지 못했는가?
_404 찾을 수 없음은 합법적인 wser_입니다.

레이블: 질문

질문에 답할 리소스가 없으면 "문서 요청" 문제를 엽니다.

우리는 모든 답변이 문서로 끝나는지 확인해야 합니다. 그렇지 않으면 여기에서 닫힌 문제가 V3 지식 기반이 되므로 이를 피해야 합니다. 따라서 "질문" 템플릿을 건너뛰고 "문서 요청"으로 바로 이동해야 할 수도 있습니다.

또한 이 리포지토리의 사용이 증가하고 이것이 질문을 하는 곳이 되고 이를 조정하는 데 어려움을 겪을 때(즉, 문서를 가리키고 문제를 닫는 경우), 우리는 미래에 그것을 후회할 수 있습니다. VS Code 와 같은 더 큰 리포지토리는 다음과 같이 공격적으로 질문해서는 안 된다고 알려줍니다.

요컨대, 고려해 봅시다.

• 질문을 전혀 허용하지 않고 "문서 요청" 문제만 허용합니다. 질문은 여전히 ​​유효하지만 실제로 문서화되지 않은 경우에만 그렇지 않으면 유효한 문서화 요청이 아니므로 종료합니다.
• 문서(있는 경우) 및 포럼에 직접 질문

문서 요청은 실제로 "질문"입니다. 그들은 무언가를 찾고 있었지만 찾을 수 없었기 때문입니다. 처음에는 답이 필요한 질문이 있습니다.
그 방향으로 가려면 github의 문제를 통해 문서 요청과 질문을 거부하는 것이 더 합리적입니다.

누군가 질문을 하고 싶다면 slack이나 핵심 팀 또는 중재자를 위한 누군가가 문서 PR/버그 문제/기능 요청 문제에서 질문을 돌릴 수 있는 포럼으로 이동합니다.

결정: https://github.com/TheThingsNetwork/lorawan-stack/issues/890#issuecomment -507324845로 갈 것입니다. 포럼으로 연결되는 질문 템플릿 및 문서 요청 템플릿