Documentação do Stack Overflow para Programadores da Microsoft

Esta mensagem foi escrita por Jeff Sandquist, Gestor Geral na Divisão Empresarial + Nuvem.

Hoje anunciamos uma parceria com o Stack Overflow para suportar a Documentação do Stack Overflow para Programadores da Microsoft. Como parte deste anúncio, anunciamos que os conteúdos da Documentação do Stack Overflow serão integrados no conteúdo de referência da API docs.microsoft.com no futuro. Há muito que a Microsoft é parceira do Stack Overflow sob a forma de etiquetas patrocinadas e o lançamento da Documentação do Stack Overflow permite que a comunidade tenha uma forma fácil de criar e votar em exemplos de código através do .NET Framework, Xamarin e outros produtos e tecnologias Microsoft.

Objetivos Partilhados

Tanto docs.microsoft.com como o Stack Overflow tinham objetivos partilhados- queremos facilitar e simplificar a contribuição da comunidade para uma excelente documentação para a utilização de produtos e serviços. Ambos os conjuntos de conteúdos têm uma licença aberta, utilizam o markdown como formato de conteúdo e permitem facilmente contribuições da comunidade (clique em Editar a partir de qualquer página docs.microsoft.com).

Uma Apresentação Rápida do Stack Overflow para Programadores .NET

Quando chegar pela primeira vez à Documentação do StackOverflow, encontrará a categorização familiar baseada em etiquetas dos tópicos disponíveis. À primeira vista, verá todas as etiquetas criadas anteriormente pela comunidade StackOverflow. Depois de filtrar por etiqueta, é apresentada uma lista de cada uma com algumas métricas importantes apresentadas imediatamente - a contagem de pedidos de tópicos, alterações propostas e pedidos de melhoria.

Pedir um Tópico

Poucos programadores resolveram problemas difíceis sem a ajuda da audiência do StackOverflow. Juntamente com os nossos colegas, colegas e legendas da comunidade que monitorizam o StackOverflow para perguntas relacionadas com os seus próprios produtos, criámos uma rede de informações organizada por etiquetas. A documentação coloca em maiúsculas o compromisso do público em criar conhecimentos coletivamente, dando-nos um local para pedir ajuda – a secção "Tópicos Pedidos" de cada etiqueta dá à comunidade um local para identificar problemas comuns.

Ao clicar em "Criar Tópico", pode criar conteúdos para o tópico, fornecer os seus próprios exemplos de código e documentação. A experiência fornece orientações sobre onde fornecer cada secção de conteúdo, que pode ser editada com a sintaxe markdown, se preferir. À medida que cria tópicos, o seu progresso é guardado na navegação correta, onde pode ver todo o conteúdo de rascunho que ainda não concluiu ou enviou para revisão.

Experiência familiar de visualização de código

Tal como acontece com o site stackOverflow Q&A, o código para tópicos individuais é apresentado num formato claro e conciso para que possa copiar-editar-utilizar ou aprender simplesmente a ler o código. Os programadores podem obter exemplos de código de voto para cima/para baixo, tal como as respostas no Stack Overflow.

Integração Futura

No futuro, docs.microsoft.com integrará uma lista organizada de exemplos de documentação do Stack Overflow diretamente na documentação da API da Microsoft. Os programadores que analisarem a referência da API da Microsoft verão ambos os exemplos criados pela Microsoft, bem como os exemplos do Stack Overflow criados pela comunidade. Os exemplos serão organizados para garantir que os exemplos de código utilizam as melhores práticas e diretrizes de codificação do .NET estabelecidas. Vamos disponibilizar mais detalhes sobre esta integração no futuro.