Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

Add Microsoft Documentation

Aberta
  • Algo errado?
#2,159 2 comentários 11 reações 0 responsáveis Ver no GitHub

Mantenedores costumam responder em até 1 dia

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
5/5
Tempo estimado
Mais de uma semana
Facilidade para iniciantes
25/100
Tipo de issue
Funcionalidade
Clareza
Precisa de esclarecimento
Status de atividade
Estagnada
Domínio
documentation, search

Direção de pesquisa

Revise os repositórios MicrosoftDocs listados na issue, começando por windows-driver-docs e seus arquivos LICENSE e LICENSE-CODE, e depois compare o contexto existente do DevDocs nas issues #158 e #2102. O trabalho estará concluído quando houver um conjunto de fontes delimitado e for confirmado o suporte à importação da documentação, ao comportamento de pesquisa e indexação e ao licenciamento de redistribuição.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

docs/new+request

Feature request

Summary

Please add the documentation from the following Microsoft sources listed below (more or less in order of importance), or as much as possible from it.

The existing search for these docs is lacking and an index doesn't exist. The offline version of the docs is huge, broken, unmaintained, and the search and index don't work either.
Furthermore, it would be convenient to have a single source for this documentation and other documentation DevDocs currently hosts (e.g. cppreference for which DevDocs also gives a superior search and index to what cppreference provides).

You could also add documentation from other repositories under https://github.com/MicrosoftDocs, such as:

The license for the documentation in all of those sources is CC-BY-4.0 which allows modification and distribution according to my understanding. The license for the code samples in the documentation is MIT.

References
  • https://github.com/freeCodeCamp/devdocs/issues/158
    Says the license is incompatible, but old - from 2015. The license now allows modification and distribution.
  • https://github.com/freeCodeCamp/devdocs/issues/2102
    New but unclear. Says the the "docs need to be available under a free license". I don't know what you consider free, but CC-BY-4.0 looks "free enough" to me. The cppreference docs you provide are licenses under CC-BY-SA-3.0 which is more restrictive, so I gather CC-BY-4.0 is good enough.
  • https://trello.com/c/PVnfdeaN
    Says that "most docs by Apple / Microsoft / Adobe, are released under restrictive licenses (no redistribution) incompatible with DevDocs", but again this is not the case with regard to the Microsoft documentation listed above.
Linguagem predominante
Ruby
Estrelas
39.5k
Forks
2.6k
Merge médio
2d 9h
PRs com merge (30d)
13

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de freeCodeCamp/devdocs

Todas as issues de freeCodeCamp/devdocs

Issues semelhantes

Mais issues de Ruby

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.