Uma atualização sobre o MSDN e a migração do TechNet para docs.microsoft.com

Este post foi escrito por Jeff Sandquist, vice-presidente corporativo de relações com desenvolvedores.

Hoje, estamos entusiasmados em fornecer uma atualização importante sobre a migração de do MSDN e conteúdo do TechNet para docs.microsoft.com. Esta postagem no blog documenta as últimas etapas de um esforço de toda a empresa para revisar a estrutura de conteúdo, formatar e a infraestrutura subjacente e centralizar a documentação técnica da Microsoft em torno de um site.

De MSDN e TechNet para docs.microsoft.com

Em 1992, Microsoft Developer Network nasceu como um serviço de assinatura do cliente para fornecer informações técnicas sobre programação para Windows. Seis anos depois, em 1998, o site msdn online foi lançado, hospedando mais de 250.000 páginas de conteúdo.

Naquela época, o processo de publicação consistia em criar conteúdo no Microsoft Word, convertê-lo em HTML e publicar por meio de uma ferramenta chamada pubwiz ( assistente de publicação). Por mais de 20 anos, o processo deu suporte à versão de novos produtos, serviços e atualizações, resultando em impressionantes 45 milhões de páginas de conteúdo técnico!

À medida que o ciclo de lançamento do produto mudava de anos para meses, a demanda por documentação acessível up-to-date cresceu. O sistema de publicação precisava corresponder à velocidade de engenharia e, portanto, decidimos inventar novamente como gerenciamos a documentação na Microsoft na era da nuvem. Em novembro de 2015, os membros fundadores da equipe de docs.microsoft.com - Dan Fernandez, Mary McHale, Carol Zeumaulte Jeff Sandquist escreveram um documento chamado "A New Hope" (uma homenagem a Star Wars Episode IV), que delineou a visão para o novo site. Ele incluiu um conjunto de princípios de orientação chave:

• documentação técnica unificada. O novo site deve consolidar as dezenas de sites de documentação hospedados pela Microsoft. Um desenvolvedor que aprende a criar um aplicativo Web controlado por dados só precisaria visitar um site para encontrar todo o conteúdo relevante no ASP.NET, no Azure, no Entity Framework ou em qualquer outra tecnologia da Microsoft.
• experiência aprimorada do usuário. Um fator fundamental na definição do sucesso de um site é a experiência que ele fornece aos seus clientes. O novo site deve ter um melhor desempenho de carregamento, fontes legíveis, tabelas acessíveis de conteúdo, URLs legíveis por humanos, suporte para controle de versão, compatibilidade com navegadores móveis e seguir as práticas de design inclusivo por meio de recursos acessíveis e suporte para internacionalização.
• democratizar a criação e o engajamento da comunidade. O novo site deve ser alimentado por padrões e ferramentas de software livre, que capacitam qualquer pessoa a criar e editar a documentação. Ele deve usar o Markdown para conteúdo, YAML para documentação de API gerada automaticamente e contar com do GitHub como a camada de conteúdo subjacente, o que permitiria o uso de verificações de qualidade automatizadas. A organização MicrosoftDocs GitHub cresceu para mais de 7.400 membros, e o do repositório de documentação do Azure é um dos projetos de software livre que mais crescem (470% ano após o ano) e o 5º mais contribuiu para o repositório em todo o GitHub, como visto noDo Estado do Octoverse 2018!
• documentação da API de Suporte. O novo site deve ter suporte de primeira classe para documentação de APIs escritas para linguagens de programação e plataformas que nossos clientes usam, incluindo .NET, Java, Python, JavaScript e TypeScript, do PowerShell, CLI do Azure, Q# , OpenAPI e muito mais. A experiência deve ser alimentada pela automação, ter uma cobertura de API confiável e poder publicar a documentação da API em minutos em vez de semanas.
• Modernizar a infraestrutura de engenharia. docs.microsoft.com deve ser executado no Azure, permitindo-nos reduzir os custos de manutenção (mais de US$ 7MM salvos), melhorar os tempos de implantação de cada três semanas para diárias (oumais rápidas) e reduzir a duplicação de engenharia.
• Extensível por padrão. À medida que o site evolui, ele deve ser capaz de atender às necessidades de nossos clientes da maneira mais eficiente. Ao assumir esse compromisso, conseguimos criar e integrar uma nova experiência de aprendizagem interativa – Microsoft Learn, bem como nosso navegador de código de exemplo .

Com uma plataforma moderna em vigor, estabelecemos para garantir que não estamos perdendo conteúdo valioso migrando-o para o novo site. Abaixo, você encontrará mais informações sobre nosso progresso.

Bibliotecas MSDN e TechNet

Status: ✅ Concluído

Iniciamos a migração da biblioteca MSDN e technet library para docs.microsoft.com no final de 2017 e concluímos a migração este ano.

As bibliotecas forneceram documentação anteriormente para produtos da Microsoft, incluindo documentação da API, código de exemplo e artigos técnicos. Originalmente disponível por meio de CDs, o conteúdo mais tarde se moveu online com o lançamento dos sites MSDN e TechNet.

A migração exigiu a conversão de uma variedade de formatos baseados em XML em Markdown para conteúdo editado por humanos e YAML para documentação de API gerada automaticamente, abrangendo mais de cem vários conjuntos de conteúdo. Garantimos que os redirecionamentos de páginas estejam em vigor para milhões de páginas da Web, evitando links quebrados referenciados fora do nosso site, como blogs e fóruns.

Para dar um vislumbre do volume de conteúdo com o qual trabalhamos, aqui estão algumas estatísticas:

• Número de tópicos disponíveis do MSDN e do TechNet: 45.4MM
• Número de tópicos migrados para docs.microsoft.com/previous-versions: 23.0MM
• Número de tópicos migrados para docs.microsoft.com: 21,0MM
• Número de repositórios criados para hospedar docs.microsoft.com/previous-versions conteúdo: 2.454

Se você tiver marcado qualquer conteúdo msdn ou technet, os links serão redirecionados diretamente para seu novo local em docs.microsoft.com.

Revista MSDN

Status: ✅ Concluído

A última edição da Revista MSDN foi publicada em 1º de novembro de 2019. Enviamos uma mensagem final para leitores e autores na edição de agosto do MSDN Magazine.

O conteúdo da Revista MSDN publicado no MSDN foi movido para learn.microsoft.com/archive.

Os assinantes da MsDN Magazine que pagaram por suas assinaturas receberão um reembolso proporcional, com base no tempo restante em sua assinatura. As verificações de reembolso serão enviadas após a publicação do problema de novembro. Essa alteração não afeta a Assinatura da Plataforma MSDN.

Microsoft Developer e TechNet Flash Newsletters

Status: ✅ Concluído

Boletins informativos publicados no do MSDN e TechNet foram movidos para docs.microsoft.com/archive.

Os assinantes atuais continuarão a receber esses boletins informativos. Podemos evoluir e alterar o formato, bem como a agenda de publicação.

Se você não quiser mais assinar nossos boletins informativos, poderá cancelar a assinatura do próximo email recebido.

Blogs msdn e technet

Status: ✅ Concluído

Fizemos os blogs MSDN e blogs technet sites somente leitura em julho de 2019. Os blogs MSDN e TechNet foram migrados e arquivados para docs.microsoft.com/archive.

Se você tiver marcado qualquer blog msdn ou technet, os links para eles serão redirecionados para o novo local no docs.microsoft.com/archiveou para outros sites de blog se eles forem ativamente mantidos e atualizados blogs.

Galeria de Códigos do MSDN

Status: ✅ Concluído

Redirecionamos todas as páginas da Galeria de Códigos do MSDN para o navegador exemplos e amostras de chave arquivadas para o GitHub na organização MicrosoftArchive. Leia mais sobre esse processo em nossa recente postagem no blog.

Você pode encontrar os exemplos de código de data up-tomais docs.microsoft.com/samples.

Galeria do TechNet

status: 🚧 em andamento

A Galeria TechNet será desativada no início de 2020. Em dezembro de 2019, o site será feito somente leitura e não aceitará mais novas contribuições da comunidade. Comunicados adicionais e informações a seguir.

Use docs.microsoft.com/samples para localizar os exemplos de código mais up-todata. Se você já contribuiu para a Galeria do TechNet, migre seus exemplos para um local gerenciado pessoalmente, como seu próprio repositório do GitHub.

TechNet Wiki

status: 🚧 em andamento

Estamos trabalhando em um plano de migração mais concreto e agendamento para wiki do TechNet. Verifique novamente mais tarde para obter mais detalhes. Você pode continuar participando e interagindo com o conteúdo wiki no momento.

Fóruns msdn e technet

status: 🚧 em andamento

Anunciamos a versão prévia do Microsoft Q&A, que substitui os fóruns MSDN e TechNet. Para garantir uma transição suave e minimizar a interrupção, dividimos a migração em várias fases. Esperamos concluir a migração até meados de 2020. Verifique novamente mais tarde para obter mais detalhes.

Canal 9

status: 🚧 em andamento

O Canal 9 continua sendo um investimento importante para conteúdo de vídeo focado no desenvolvedor. Estamos trabalhando em um caminho de migração que integrará melhor nossos vídeos e conteúdo técnico do Channel 9. Verifique novamente mais tarde para obter mais detalhes.

Queremos ouvir de você

Estamos entusiasmados em continuar investindo em nossa plataforma e garantir que você obtenha a documentação técnica mais relevante e confiável para todo o ecossistema da Microsoft. Dê-nos suas ideias e sugestões de melhoria sobre do GitHub e do Twitter.