콘텐츠로 이동

기여하기

AWS 네트워킹 모범 사례 가이드에 오신 것을 환영합니다! 저희는 여러분과 같은 사용자들의 기여로 성장하는 커뮤니티 기반 프로젝트입니다. 문제를 보고하든, 개선을 제안하든, 전문 지식을 나누든, 모두를 위한 더 나은 가이드를 만드는 데 여러분의 도움을 환영합니다.

처음 기여하시나요?

시작하는 가장 일반적인 방법은 다음과 같습니다:

빠른 시작 가이드

오류나 누락된 정보를 발견하셨나요? → 수정 사항 보고

네트워킹 관련 질문이 있으신가요? → AWS re:Post에서 질문하기

새로운 모범 사례를 제안하고 싶으신가요? → 새 모범 사례 요청

콘텐츠를 직접 기여하고 싶으신가요? → 풀 리퀘스트 생성

대부분의 기여는 문제를 보고하거나 질문을 하는 것에서 시작됩니다. 처음부터 완벽하지 않아도 괜찮습니다 – 커뮤니티가 도와드립니다!

이슈 생성 또는 기여하기

기여 가이드라인

기여를 최대한 쉽게 할 수 있도록 프로세스를 간소화했습니다. 이 간단한 가이드라인을 따라 주시면 저희가 여러분의 기여에 신속하고 효과적으로 응답할 수 있습니다.

체크리스트

프로젝트 내에서 활동하기 전에 잠시 시간을 내어 다음 사항을 검토해 주세요. 이를 통해 올바른 이슈 템플릿을 사용하고 있는지 확인하고, 커뮤니티와 소통할 때 필요한 모든 정보를 제공할 수 있습니다.

좋은 기여 vs. 부족한 기여

✅ 좋은 예시

문서 공백: "네트워킹 기초 섹션에 멀티 리전 배포를 위한 CIDR 블록 계획 지침이 부족합니다. 소규모(VPC 10개 미만) 및 대규모(VPC 50개 초과) 조직에 대한 예시를 포함하여 IP 주소 할당 전략을 다루는 모범 사례 섹션을 기여하고 싶습니다."

콘텐츠 개선: "현재 AWS 내 연결 섹션은 기본 설정을 다루고 있지만 고급 라우팅 시나리오가 누락되어 있습니다. 구체적인 예시와 다이어그램을 포함하여 허브 앤 스포크 아키텍처를 위한 라우팅 테이블 설계 패턴 섹션을 추가할 수 있습니다."

새로운 모범 사례: "프로덕션 환경에서 AWS Network Firewall을 사용한 경험을 바탕으로, 비용 고려 사항 및 모니터링 전략을 포함한 규칙 최적화 및 성능 튜닝에 관한 섹션을 기여하고 싶습니다."

❌ 부족한 예시

모호한 요청: "네트워킹에 대한 정보가 더 필요합니다"

너무 광범위함: "모든 문서를 수정해 주세요"

맥락 없음: "보안 그룹에 대한 내용을 추가해 주세요"

커뮤니티 가이드라인

모든 기여는 공개적이며 영구적으로 유지됩니다. 건설적이고 서로를 존중하는 방식으로 기여해 주시고, 행동 강령을 따라 주세요.

기여 전 확인 사항

여러분의 기여가 도움이 되고 주목받을 수 있도록 다음 체크리스트를 확인해 주세요:

  • 먼저 검색하기: 동일한 문제가 이미 보고되었거나 유사한 질문이 있는지 확인하세요

  • 올바른 채널 사용하기:

  • 기술적인 질문 → AWS re:Post

  • 버그 보고 또는 기능 요청 → GitHub Issues

  • 맥락 제공하기: AWS 서비스, 리전, 오류 메시지 등 관련 세부 정보를 포함하세요

  • 서로 존중하기: 행동 강령을 따르고 건설적인 토론을 유지하세요

참고

이슈 템플릿을 완전히 작성하면 요청 사항을 더 빠르게 이해할 수 있습니다. 확실하지 않은 부분이 있어도 걱정하지 마세요 – 커뮤니티가 도와드립니다!

권리와 책임

메인테이너로서 저희는 커뮤니티 내 소통을 조율할 책임을 맡고 있으며, 이슈, 토론, 댓글, 커밋을 종료, 삭제, 거부 또는 편집하고, 기여 가이드라인 및 행동 강령에 부합하지 않는 사용자를 차단할 권한을 가집니다.

이 역할은 커뮤니티의 건전성과 긍정적인 분위기를 유지하는 데 적극적으로 참여할 것을 요구합니다. 이러한 기준을 단호하게 지킴으로써 모든 구성원을 위한 존중적이고 포용적인 환경을 보장합니다.

행동 강령

저희 행동 강령은 모든 커뮤니티 구성원이 포용적이고 환영하는 언어를 사용하여 서로를 존중할 것을 기대합니다. 저희는 부적절하거나 불쾌하거나 해로운 행동이 없는 긍정적이고 지지적인 환경을 조성하기 위해 노력합니다.

저희는 모든 위반 사항을 심각하게 받아들이며 이러한 가치를 지키기 위해 적절한 조치를 취할 것입니다.1

불완전한 이슈 및 중복 이슈

저희는 이슈를 효과적으로 검토하고 응답하기 위한 필수 요건을 평가하는 기여 프로세스 구축에 상당한 시간과 노력을 투자했습니다. 이슈 템플릿의 각 항목은 여러분의 우려 사항과 문제의 성격을 충분히 이해할 수 있도록 신중하게 설계되었습니다. 중복을 방지하기 위해 새로운 이슈를 제출하거나 토론을 시작하기 전에 검색 기능을 활용해 주시기 바랍니다. 여러분의 협조는 커뮤니티 토론을 건설적이고 체계적으로 유지하는 데 매우 중요합니다.

  • 이슈 템플릿 필수 완성: 이슈 템플릿에서 요구하는 모든 정보가 필요한 이유는, 경험 수준에 관계없이 모든 사용자와 메인테이너가 버그 보고 또는 변경 요청의 내용과 심각도를 이해할 수 있도록 보장하기 위해서입니다.

  • 불완전한 이슈 종료:

저희는 필수 정보가 누락된 이슈를 종료할 권리를 보유합니다. 예를 들어 이슈 템플릿에 명시된 품질 기준 및 요건을 준수하지 않는 이슈가 이에 해당합니다. 이러한 이슈는 누락된 정보가 제공된 후 다시 열 수 있습니다.

  • 중복 처리: [이슈 트래커] 내에서 체계적이고 효율적인 소통을 유지하기 위해, 저희는 중복된 이슈를 종료할 권리를 보유합니다. 동일한 질문을 하거나 동일한 문제를 여러 포럼에 걸쳐 보고하는 것은 커뮤니티 우려 사항을 관리하고 해결하는 저희의 능력을 저해합니다. 이 접근 방식은 효율적인 시간 관리를 위해 매우 중요하며, 중복된 질문은 여러 팀원의 시간을 동시에 소모할 수 있습니다. 각 이슈나 토론이 고유하고 새로운 정보로 진행되도록 보장하면 집중력을 유지하고 커뮤니티를 지원하는 데 도움이 됩니다.

    저희는 또한 새로운 정보 없이 재개되거나 단순히 이슈/질문에 대한 응답을 아직 받지 못했다는 이유로 재개된 이슈를 즉시 종료할 권리를 보유합니다. 해당 이슈는 불완전한 것으로 표시됩니다.

  • 자동화 도구의 한계: 저희는 자동화 도구가 잠재적인 문제를 식별하는 데 가져다주는 가치와 효율성을 믿지만(Lighthouse, 접근성 도구 등에서 식별된 문제 포함), 이러한 도구로 생성된 이슈를 단순히 제출하는 것은 완전한 버그 보고서로 간주되지 않습니다. 이러한 도구는 때때로 장황한 출력을 생성하고 오탐(false positive)을 포함할 수 있어 비판적인 평가가 필요합니다. 물론 생성된 보고서를 이슈에 첨부하는 것은 환영합니다. 그러나 이것이 최소한의 재현 방법이나 결과에 대한 철저한 논의 요건을 대체하지는 않습니다. 저희는 이러한 이슈를 불완전한 것으로 표시하고 종료할 권리를 보유합니다. 이 관행은 광범위한 자동화 출력을 탐색하는 것이 아니라 정확성과 명확성을 가지고 실제 우려 사항을 해결하기 위한 것입니다.

  1. 경고 및 차단 정책: 프로젝트의 인기가 높아지고 건강한 커뮤니티에 대한 저희의 의지를 바탕으로, 위반 사항 처리 방식에 대한 명확한 가이드라인을 정의했습니다:

    1.1. 첫 번째 경고: 반복적으로 부적절하거나 불쾌하거나 해로운 행동을 보이는 사용자는 첫 번째 경고를 받게 됩니다. 이 경고는 해당 행동이 커뮤니티 기준 및 행동 강령에 부합하지 않는다는 공식 통보입니다. 첫 번째 경고는 영구적으로 유지됩니다.

    1.2. 두 번째 경고 및 해결 기회: 행동이 지속될 경우 두 번째 경고가 발행됩니다. 두 번째 경고를 받은 사용자에게는 5일간의 반성 기간이 주어지며, 이 기간 동안 자신의 행동에 대해 공개적으로 설명하거나 사과할 것을 권장합니다. 이 기간은 오해를 공개적으로 해소할 기회를 제공하기 위해 마련되었습니다.

    1.3. 차단: 두 번째 경고 이후에도 응답이 없거나 행동이 개선되지 않을 경우, 저희는 해당 사용자를 커뮤니티 및 저장소에서 차단할 권리를 보유합니다. 차단은 커뮤니티의 건전성과 긍정적인 분위기를 보호하기 위해 절대적으로 필요한 경우에만 사용되는 최후의 수단입니다.

    차단은 저희의 압도적으로 긍정적인 커뮤니티에서 극히 드물게 필요했으며, 이는 건설적인 대화와 상호 존중에 대한 저희의 선호를 잘 보여줍니다. 차단은 커뮤니티 구성원과 팀을 보호하기 위한 것입니다. ↩