Microsoft 개발자를 위한 Stack Overflow 설명서

이 게시물은 클라우드 + 엔터프라이즈 사업부의 총괄 관리자인 Jeff Sandquist에 의해 작성되었습니다.

오늘 Microsoft 개발자를 위한 Stack Overflow 설명서를 지원하기 위해 Stack Overflow와 파트너 관계를 발표합니다. 이 발표의 일환으로 향후 Stack Overflow 설명서 콘텐츠가 docs.microsoft.com API 참조 콘텐츠에 통합될 예정임을 알려 드립니다. Microsoft는 오랫동안 스폰서 태그 형태로 Stack Overflow와 파트너 관계를 유지해 왔으며, Stack Overflow 설명서의 출시를 통해 커뮤니티는 .NET Framework, Xamarin 및 기타 Microsoft 제품 및 기술을 사용하여 코드 샘플을 쉽게 만들고 투표할 수 있습니다.

공동의 목표

docs.microsoft.com과 Stack Overflow는 공동의 목표를 가지고 있습니다. 커뮤니티가 제품 및 서비스 사용을 위한 훌륭한 설명서를 쉽게 작성할 수 있도록 하는 것입니다. 두 콘텐츠 집합 모두 개방형 라이선스가 있고, markdown을 콘텐츠 형식으로 사용하며, 커뮤니티에 쉽게 기여할 수 있습니다(docs.microsoft.com 페이지에서 편집 클릭).

.NET 개발자를 위한 Stack Overflow 빠른 둘러보기

StackOverflow 설명서에 처음 도착하면 사용 가능한 항목의 친숙한 태그 기반 분류를 찾을 수 있습니다. StackOverflow 커뮤니티가 이전에 만든 모든 태그를 한눈에 볼 수 있습니다. 태그별로 필터링하면 각 목록이 몇 가지 중요한 메트릭(토픽 요청 수, 제안된 변경 내용, 개선 요청)과 함께 표시됩니다.

토픽 요청

StackOverflow 대상 그룹의 도움 없이 어려운 문제를 해결한 개발자는 거의 없습니다. 자체 제품과 관련된 질문을 위해 StackOverflow를 모니터링하는 커뮤니티의 동료 및 범례와 함께 태그별로 구성된 정보 네트워크를 빌드했습니다. 설명서는 도움을 요청할 수 있는 장소를 제공하여 지식을 집단적으로 구축하려는 대상 집단의 노력을 활용합니다. 각 태그의 "요청된 토픽" 섹션은 일반적인 문제를 식별할 수 있는 장소를 커뮤니티에 제공합니다.

"토픽 만들기"를 클릭하면 토픽의 콘텐츠를 만들고 자체 코드 샘플과 설명서를 제공할 수 있습니다. 이 환경은 원하는 경우 Markdown 구문을 사용하여 편집할 수 있는 콘텐츠의 각 섹션을 제공할 위치에 대한 지침을 제공합니다. 토픽을 만들면 진행 상황이 오른쪽 탐색에 저장되며, 여기서 아직 완료하지 않았거나 검토를 위해 보내지 않은 초안 콘텐츠를 모두 볼 수 있습니다.

친숙한 코드 보기 환경

StackOverflow Q&A 사이트와 마찬가지로 개별 토픽의 코드는 명확하고 간결한 형식으로 표시되므로 코드를 읽는 것만으로도 복사-편집-사용하거나 학습할 수 있습니다. 개발자는 Stack Overflow에서의 답변처럼 코드 샘플에 대한 추천/반대 투표를 할 수 있습니다.

향후 통합

향후 docs.microsoft.com은 큐레이팅된 Stack Overflow 설명서 샘플 목록을 Microsoft API 설명서에 직접 통합할 예정입니다. Microsoft API 참조를 보는 개발자는 Microsoft에서 만든 샘플과 커뮤니티에서 만든 Stack Overflow의 샘플을 모두 볼 수 있습니다. 샘플은 코드 샘플이 설정된 .NET 코딩 지침 및 모범 사례를 사용하도록 큐레이팅됩니다. 이 통합에 대한 자세한 내용은 나중에 릴리스할 예정입니다.