기여하기
이 안내서에는 이슈와 풀 리퀘스트로 기여할 수 있습니다.
다음 작업에 특히 도움을 받을 수 있습니다.
- 맞춤법과 문법 오류 수정
- 기술적으로 부정확한 설명 수정
- 코드 예제의 논리 오류와 컴파일 오류 수정
- 영어 문장 개선
- 주제나 개념을 더 쉽게 이해할 수 있는 설명 보강
- C#, .NET, Rust의 변경 사항 반영. 두 언어의 기능이 가까워지면 설명과 예제도 수정할 수 있습니다.
맞춤법이나 예제의 구문 오류처럼 범위가 작은 수정은 바로 풀 리퀘스트를 제출할 수 있습니다. 작성자와 검토자 모두에게 큰 노력이 필요한 변경이라면 작업을 시작하기 전에 이슈에서 관리자나 편집자의 동의를 구하는 방식을 안내합니다. 그러면 작업을 마친 뒤 풀 리퀘스트가 거절될 위험을 줄일 수 있습니다.
웹에서 안내서를 읽다가 오류를 발견했다면 페이지 모서리의 편집 아이콘을 통해 해당 Markdown 원본을 수정하고 변경 사항을 제출할 수 있습니다.
기여 지침
- 소개에서 밝힌 안내서의 목표를 따르고 다루지 않는 범위를 벗어나지 않습니다.
- 설명은 짧게 쓰고 간결하면서 현실적인 코드 예제를 사용합니다.
- 가능한 한 Rust와 C#의 예제를 모두 제시하고 비교합니다.
- 예제가 간결해지거나 두 언어의 공통점을 잘 드러낸다면 최신 C# 및 Rust 기능을 사용할 수 있습니다.
- C# 예제에서는 가능한 한 커뮤니티 패키지보다 .NET 기본 클래스 라이브러리를 사용합니다. Rust 표준 라이브러리의 API 범위는 비교적 작으므로 기능을 설명하는 데 crate가 필요할 수 있습니다. 이때는
rand처럼 널리 쓰이고 신뢰할 수 있는 패키지를 선택합니다. - 예제 코드는 가능한 한 독립적으로 실행할 수 있게 만듭니다. 컴파일 오류나 실행 오류를 보여 주려는 예제는 예외입니다.
- 독자에게 직접 지시하는 2인칭 표현을 피하고 3인칭으로 설명하는 문체를 유지합니다. 예를 들어 "Rust에서 선택적 데이터를 나타내려면
Option<T>를 사용하세요"보다 "Rust의Option<T>타입은 선택적 데이터를 나타냅니다"처럼 씁니다.