Notas sobre a versão – janeiro de 2019

Esta postagem foi escrita por Den Delimarsky, gerente de programa na divisão de nuvem e IA.

Bem-vindo a outra edição das notas sobre a versão do docs.Microsoft.com, a primeira em 2019. Estamos empolgados para continuar a aprimorar as experiências com novas ferramentas e aprimoramentos do conteúdo e para reconhecer mais colaboradores da comunidade!

Colaboradores da Comunidade

Nossa comunidade é a chave para muitos aprimoramentos na documentação que hospedamos. Ao ler um artigo no docs.Microsoft.com, saiba que provavelmente ele contém a contribuição de alguém tão dedicado à precisão e à qualidade geral da documentação como nós. Centenas de pessoas dedicam horas para aprimorar nossa documentação para todos! Queremos reconhecer algumas delas na postagem no blog deste mês.

Se você tem interesse em contribuir para nosso conteúdo, comece com o guia do colaborador.

Valeriy Novytskyy

Também conhecido como 01binary no GitHub, Valeriy fez um trabalho fantástico melhorando a documentação do ASP.NET Core, com o aprimoramento dos exemplos de código de segurança. Os exemplos de código são usados pelos desenvolvedores para iniciar projetos e explorações. Nós ficamos muito satisfeitos de ver como eles vão ficando mais completos e confiáveis.

Dave Brock

Dave é um colaborador ativo na documentação do ASP.NET Core. Ele já enviou mais de dez solicitações de pull diferentes para aumentar a precisão e a facilidade de uso da documentação em apenas alguns meses! Ele está no Twitter como @daveabrock.

Lynn Park

Lynn é uma nova colaboradora no Docs e a primeira PR dela acabou de entrar na documentação do Entity Framework! Ela é uma leitora frequente do docs.microsoft.com que decidiu retribuir e fez a primeira contribuição de código aberto corajosamente. Encontre-a no Twitter.

Lançamentos de conteúdo

À medida que nossa oferta de produtos aumenta, buscamos sempre oferecer a documentação mais atualizada e relevante possível aos usuários. Este mês, expandimos a biblioteca de conteúdo no docs.microsoft.com adicionando a nova documentação da API Java para os Serviços de Mídia do Azure, a documentação da API do .NET para Windows Server 2019, a documentação da API REST para Data Lake Storage Gen2 e uma atualização da documentação do QnA Maker dos Serviços Cognitivos em Python.

Recursos

Extensão markdownlint para dar suporte ao Markdown personalizado no Docs

Um dos componentes mais populares do Pacote de Criação do Docs para VS Code é o markdownlint do desenvolvedor Microsoft David Anson, que ajuda os colaboradores a garantir que o conteúdo siga as práticas recomendadas de Markdown. Agora, o markdownlint é extensível, e a equipe de engenharia do Docs começou a adicionar regras personalizadas para dar suporte a extensões Markdown específicas do Docs. Essas regras são instaladas como parte do Pacote de Criação do Docs, portanto, se você usar o pacote, não precisará fazer nada especial para iniciar o lint de Markdown do Docs.

Um link mais personalizado será lançado em breve, incluindo a verificação de links seguros (https://) e o lint de sintaxe de alertas do Docs, como [!NOTE], facilitando ainda mais a contribuição de novo conteúdo para o docs.microsoft.com.

Notas de rodapé

Há mais coisas planejadas para este ano em inúmeras áreas do espaço de documentação! Para estar sempre atualizado, siga nosso blog e a conta do Twitter. Se você tiver sugestões ou ideias de recursos, não se esqueça de abrir um novo problema no GitHub.