요약
이 문서에서는 Discourse에서 기능 요청을 작성하는 방법을 단계별로 안내합니다.
1단계: 시작하기 전
Discourse에 추가할 좋은 아이디어가 있으신가요? 정말 좋습니다! 팀과 커뮤니티에 효과적으로 공유하는 방법을 안내해 드리겠습니다. 기능 요청을 제출하기 전에, 기존 토론을 검색하여 아이디어가 이미 제안되었거나 구현되었는지 확인해 주세요. 이를 확인하는 방법은 다음과 같습니다.
- Contribute > Feature 카테고리를 확인합니다.
- 페이지 오른쪽 위 구석의
아이콘을 클릭하여 검색을 실행합니다. 고급 필터를 사용하여 카테고리별로 필터링할 수 있습니다. - pr-welcome 태그가 있는 주제를 살펴봅니다. PR은 GitHub의 풀 리퀘트(Pull Request)를 의미하며, 개발자가 프로젝트에 새로운 코드를 도입하는 방법입니다.
- completed 태그가 있는 주제를 살펴봅니다.
- Customization > Plugin 및 Customization > Theme component 카테고리를 확인합니다.
제안하신 기능이 이미 목록에 있다면, 투표하여 해당 요청의 가시성을 높이고, 좋아요를 누르거나 추가적인 아이디어나 사용 사례에 대해 답변함으로써 그 유용성을 강조하여 기능이 추가되어야 하는 이유를 더 잘 전달할 수 있습니다.
아이디어에 대한 언급을 찾을 수 없나요? 그렇다면 기능 요청을 생성할 수 있습니다.
2단계: 기본 사항
제목
주제 제목은 정보를 충분히 담고 있으면서도 너무 길지 않아야 합니다. 요청의 범위가 한눈에 쉽게 파악될 수 있어야 합니다.
카테고리
새 주제를 생성할 때 Contribute > Feature 카테고리를 선택해 주세요.
태그
태그는 기능을 그룹화하고 분류하는 데 사용되므로, 요청을 조직적으로 유지하기 위해 주제를 적절히 태그하는 것이 추적에 매우 유용합니다. 예를 들어, chat 플러그인과 관련된 모든 내용은 하나의 태그 아래에 모아집니다.
3단계: 요청 작성하기
좋은 기능 요청을 작성하는 것은 중요합니다. 이는 Discourse 팀이 개선이 필요한 영역을 빠르게 식별하는 데 도움이 됩니다.
기능 요청을 생성할 때, 여러분의 아이디어를 제안하고 그 기능이 잘 근거가 있다는 점을 사람들에게 설득하려는 것입니다. 커뮤니티, 여러분 자신, 그리고 팀을 위해 왜 여러분의 기능이 추가되어야 하는지 설명해 주세요.
주제 본문에서 요청하는 기능을 간결하게 서술하세요. 구체적이고 설명적으로 작성하며, 모호하거나 개방형으로 작성하지 않도록 주의하세요.
맥락과 설명 제공
기능 요청에 대한 맥락과 설명을 제공하세요.
- 요청하는 기능에 대한 명확한 설명
- 현재 겪고 있는 문제나 사용 사례 및 해당 기능이 이를 어떻게 해결하는지 포함
- 수행한 관련 배경 정보나 조사 내용
예시 및 스크린샷 제공 (선택 사항)
해당되는 경우, 기능 요청을 시각적으로 쉽게 이해할 수 있도록 예시, 목업(mock-up) 또는 스크린샷을 제공하세요.
커뮤니티와 소통하기
기능 요청을 생성한 후에는 질문과 피드백에 답변을 남기며 커뮤니티 멤버들과 소통하세요. 이는 요청이 고려될 가능성을 높이는 데 도움이 됩니다.
다음 단계에서 기대할 수 있는 것
기능 요청을 제출한 후에는 커뮤니티와 Discourse 팀이 검토합니다. 다음을 기대할 수 있습니다:
- 커뮤니티의 피드백 및 토론
- 요청이 실현 가능한지 그리고 고려되고 있는지 여부를 알려주는 Discourse 스태프의 답변
- 향후 업데이트에서 기능 요청이 구현될 가능성
기능이 반드시 만들어지도록 하려면?
일부 경우, 기능 요청은 코어(기본 기능)에 적합하지 않을 수 있습니다. 기능 결정 과정에 대해 읽기. 직접 기능을 개발할 수 없더라도, 구현 가능성을 높이는 방법이 여전히 있습니다.
discourse.org 고객이 되기
우리와 함께 사이트를 호스팅하여 개발을 후원하고 싶으시다면, 이는 더 빠르게 기능을 반영하는 방법 중 하나입니다. 우리는 개발 타임라인에서 고객 요청을 항상 우선시합니다. 엔터프라이즈 고객은 시간당 요금으로 코어 팀에게 맞춤형 기능(보통 플러그인 형태)을 요청할 수 있습니다.
“pr-welcome” 작업 후원하기
우리는 pr-welcome 주제에 대한 포괄적인 목록을 보유하고 있습니다. 이는 완료되기를 원하지만 현재 자체적으로 작업할 여유가 없는 과제들입니다. 이러한 작업을 수행할 사람을 후원하는 것은 참여하는 좋은 방법이며, Discourse에 대한 모든 기여는 큰 감사를 드립니다.
마켓플레이스에서 유료 작업 제안하기
비즈니스에 필수적인 플러그인이 있다면, #marketplace::category에서 유료 과제를 광고하세요. 스크린샷과 예산을 포함하여 가능한 한 많은 세부 정보를 제공하세요. “원타임 설치” 또는 "맞춤형 테마"와 같은 표준화된 마이크로서비스를 제공하는 프리랜서를 발견할 수도 있습니다.
전체 요약
일반적인 권장 사항 및 금지 사항
권장 사항 (Do)
- 요청은 간결하게 유지하고 단일 기능에 집중하세요.
- 구현 방식이나 기술적 세부 사항에 대한 가정은 피하세요.
- 커뮤니티 피드백에 기반하여 아이디어를 타협하고 적응할 의지를 보이세요.
금지 사항 (Don’t)
- 주제당 하나의 기능 이상을 포함하지 마세요.
- 다른 사용자가 요청의 범위에 대해 의문을 가질 수 있도록 두지 마세요.
자주 묻는 질문 (FAQ)
Q: 상세한 기능 요청을 만들 시간이 없다면 어떻게 해야 하나요?
A: 그 순간 상세한 요청을 만들 수 없다면, 말하고 싶은 내용을 숙고한 후 나중에 다시 시도해 보세요. 이렇게 하면 최선의 주장을 펼칠 수 있어 다른 사람들이 요청을 지지하고 기능이 추가될 가능성이 높아집니다.
Q: 기능 요청을 어디에 게시해야 하나요?
A: 적절한 카테고리를 사용하세요 - 기능 요청은 #feature::category 카테고리에 게시해야 합니다.
Q: 요청에 어떤 태그를 사용해야 할지 확신이 서지 않는다면 어떻게 해야 하나요?
A: 태그는 사용 편의성을 위해 플러그인과 테마 컴포넌트 이름과 일치하지만, 태그가 비어 있으면 팀 멤버나 Regular(정규 사용자)가 적절한 태그를 주제에 추가해 줍니다.
요청 시 존중하고 열린 마음을 가져 주세요. 기능 요청을 통해 불만을 표현하는 것은 피하세요. 부적절한 언어나 행동은 요청이 지연되거나 무시될 수 있습니다.
추가 자료
- 카테고리: Contribute > Feature, Marketplace, Customization > Plugin, Customization > Extras, Customization > Theme, Customization > Theme component
- 태그: current-projects, release-notes, pr-welcome, planned
- https://meta.stackexchange.com/questions/258136/how-do-i-write-a-good-feature-request
- How do we decide what goes into each release of Discourse?
- Discourse pricing | Discourse - Civilized Discussion
