nlweb-ai/nlweb-net

🧰 Docs: Troubleshooting common build/restore issues

Aberta

#83 aberto em 18 de ago. de 2025

Ver no GitHub
 (0 comentário) (0 reação) (0 responsável)C# (8 forks)auto 404
docsgood first issue

Métricas do repositório

Stars
 (23 estrelas)
Métricas de merge de PR
 (Nenhuma PRs mesclada em 30d)

Description

Collect frequent stumbling blocks into a small Troubleshooting section.

Scope

  • Add a Troubleshooting section to the root README.md or doc/development-guide.md
  • Cover:
    • .NET SDK version mismatches
    • NuGet feeds (using NuGet.Config and central Directory.Packages.props)
    • Docker dotnet restore tips (copy props/feeds early)
  • Keep it concise with links to detailed docs

Acceptance Criteria

  • New contributors can quickly self-unblock common restore/build problems

Labels: docs, good first issue

Guia do colaborador

Direção de pesquisa
Revise a documentação existente e os padrões comuns de falha de build nos problemas do repositório. Crie uma seção de solução de problemas concisa abordando incompatibilidades de versão do .NET SDK, configuração de feed NuGet e otimizações de restauração do Docker.
Pilha de tecnologia
csharp
Domain
documentation
Tipo Issue
Documentação
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Recente
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
Git
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
80