Complementando o que o bigown disse, a solução é focar em deixar o exemplo da pergunta em algo mínimo, completo e verificável. Ou seja:
- Mínimo: Tudo o que está na pergunta é necessário para reproduzir o problema. Nenhuma parte é supérflua.
- Completo: Todas as partes relevantes para reproduzir o problema estão postados na pergunta.
- Verificável: O que foi postado na pergunta é suficiente para reproduzir o problema.
Também convém dizer o que faz a sua pergunta não ser algo mínimo, completo e verificável:
- Classes ou arquivos referenciados que não estão na pergunta (não é completo).
- Classes ou arquivos postados apenas de forma parcial (não é completo).
- Ao executar os procedimentos descritos na pergunta, o erro não acontece (não é verificável).
- O conteúdo da pergunta não contém todas as informações necessárias para se reproduzir o problema (não é verificável).
- Apenas o código, sem a descrição do problema (não é completo).
- Ausência de código (não é completo e nem verificável).
- Um monte de classes, arquivos, métodos ou etapas descritas que não têm relação com o problema (não é mínimo).
- O código não compila, mas o problema não é o erro de compilação em questão (não é verificável).
- O código utiliza bibliotecas ou funções que não estão especificadas ou descritas em lugar nenhum (não é completo e nem verificável).
Se o projeto depende de muita coisa gerada automaticamente, para tornar o seu exemplo mínimo, completo e verificável, você pode adicionar instruções de como gerar o projeto com todas as coisas que aparecem automaticamente. Por exemplo:
Criei um projeto Java Web padrão no Netbeans, incluindo o Hibernate como biblioteca, e coloquei no pacote com.example
as classes que seguem abaixo.
public class MinhaClasse {
public void hello() {
System.out.println("Hello World");
}
}
Estou usando o Netbeans 8.0.1 com o Glassfish 4.1.1 e a JDK 1.8.0_102. A versão do Hibernate é a que o Netbeans acrescentou automaticamente como biblioteca no projeto.
Está ocorrendo o erro abaixo:
Stacktrace, mensagens de erro de compilação, saída do programa, etc.
Alguém sabe me explicar porque o erro ocorre? O que posso fazer para consertar?
Observe que neste exemplo, você:
- Descreve o problema obtido.
- Descreve quais são os passos exatos para reproduzir o problema.
- Detalha quais são as versões necessárias para cada pacote/biblioteca/IDE/seja-lá-o-que-for.
Isso daí deixa o conteúdo da sua pergunta completo e verificável. Ou seja, ele contém todas as instruções necessárias para reproduzir o problema. Fazer o exemplo ser completo e verificável não é apenas despejar todo o código-fonte na questão, mas sim dizer o que deve-se fazer com tal código para reproduzir o problema.
Além de ser completo e verificável, é importante que ele seja mínimo. Não coloque na pergunta, coisas que não têm relação com o problema. Ou seja, retire tudo aquilo que você conseguir do seu projeto sem que ele deixe de ser completo e verificável. Quando você chegar em um ponto onde qualquer coisa que for retirada faria o seu projeto ou deixar de ser completo ou deixar de ser verificável, então é porque chegou ao ponto em que ele é mínimo.
Se grande parte do código é gerado automaticamente, então convém explicar quais são os passos para gerá-lo. Se ao invés disso, o autor da pergunta apenas despejar linhas e mais linhas desse código, poderá acabar confundindo ou dificultando o trabalho de quem for responder a pergunta, uma vez que a pergunta ficará com seu conteúdo inchado e poluído e quem for responder pode não perceber que o código foi gerado automaticamente, focando parte da sua atenção em partes sem importância. Colocar todo o código em algum arquivo ZIP em qualquer lugar da internet ao invés de colocar na pergunta não torna as coisas melhores. Observe que trocar um monte de código gerado automaticamente por uma simples descrição de como configurar o projeto é uma forma de deixar o seu exemplo mais mínimo.
Por fim, se o que você quer fazer demanda que as coisas geradas automaticamente precisem de uma configuração bem específica, daí você descreve como é que se faz essa configuração bem específica:
- Abra o Netbeans (estou usando a versão 8.0.1 com a JDK 1.8.0_102).
- Clique no menu "Arquivo".
- Escolha a opção "Novo Projeto".
- Escolha o item "Java Web".
- Escolha a opção "Aplicação Web".
- Dê o nome do projeto de "Teste" e coloque-o em alguma pasta qualquer.
- ...
- ...
...
25. Copie o arquivo meuteste.xml
para a pasta xpto
.
26. Compile o projeto.
27. Observe o erro que ocorre (stacktrace abaixo). Por que isso acontece? Como corrigir?
Entretanto, antes de postar coisas que demandem passos de configuração complexos, certifique-se que eles são estritamente necessários e que têm relação com o problema. Isso daí tem a ver com a parte do "mínimo": se você puder dispensar algumas etapas ou usar uma forma de configuração mais padrão e com menos configurações específicas, melhor.
Mas, se você descreveu todos os passos necessários para a reprodução do seu problema, incluindo como gerar automaticamente tudo que for necessário, deixou o conteúdo da sua pergunta mínimo, completo e verificável, e mesmo assim quiser deixar um link para o ZIP, então tudo bem. Neste caso o ZIP seria um acessório a mais para ajudar quem for responder, e não algo estritamente necessário na pergunta. Além disso, quem for responder poderia executar os passos descritos e comparar o resultado com o ZIP, podendo tirar conclusões interessantes tanto no caso de o resultado ser o mesmo quanto no caso de o resultado divergir.
Por fim, code review não está no escopo do StackOverflow em inglês mesmo, mas eles tem um site na rede exatamente com essa finalidade: http://codereview.stackexchange.com. Por outro lado, na nossa versão em português, o codereview é considerado como parte do escopo sim, embora tenhamos poucas questões desse tipo.