html 🤝 Contribuindo | Nullcore
Pule para o conteúdo principal

🤝 Contribuindo

Patrocinado porUrdidura
Warp
O terminal inteligente para desenvolvedores

Bem -vindo, colaboradores!

Seu interesse em contribuir para o Nullcore é muito apreciado. Este documento está aqui para guiá -lo pelo processo, garantindo que suas contribuições aprimorem o projeto de maneira eficaz. Vamos tornar o webui aberto ainda melhor, juntos!

💡 Contribuindo

Procurando contribuir? Ótimo! Veja como você pode ajudar:

🌟 Diretrizes de contribuição de código

Congratulamo -nos com pedidos de puxão. Antes de enviar um, por favor:

  1. Abra uma discussão sobre suas idéiasaqui
  2. Siga os padrões de codificação do projeto e inclua testes para novos recursos.
  3. Atualize a documentação conforme necessário.
  4. Escreva mensagens de confirmação claras e descritivas.

🛠 Código práticas recomendadas de RP:

  1. PRs atômicos:Verifique se seus PRs são pequenos, focados e lidar com um único objetivo ou tarefa. Isso ajuda a revisar mais fáceis e limitar as chances de introduzir questões não relacionadas. Se o escopo das mudanças crescer muito, considere dividi -las em PRs menores e logicamente independentes.
  2. Siga a Convenção de Código Existente:Verifique se o seu código está alinhado aos padrões e práticas de codificação existentes do projeto.
  3. Evite dependências externas adicionais:Não inclua dependências externas adicionais sem discussão prévia.
  4. Abordagem agnóstica -quadro:Nosso objetivo é manter a estrutura agnóstica. Implementar funcionalidades por conta própria sempre que possível, em vez de confiar em estruturas ou bibliotecas externas. Se você tiver dúvidas ou sugestões sobre essa abordagem, sinta -se à vontade para discuti -la.

Obrigado por contribuir! 🚀

📚 Documentação e tutoriais

Ajude -nos a tornar o Webui aberto mais acessível, melhorando a documentação, escrevendo tutoriais ou criando guias sobre como configurar e otimizar a interface da web.

🌐 Traduções e internacionalização

Ajude -nos a disponibilizar o webui aberto para um público mais amplo. Nesta seção, o guiaremos através do processo de adição de novas traduções ao projeto.

Usamos arquivos JSON para armazenar traduções. Você pode encontrar os arquivos de tradução existentes nosrc/lib/i18n/localesdiretório. Cada diretório corresponde a um idioma específico, por exemplo,en-USpara inglês (nós),fr-FRpara francês (França) e assim por diante. Você pode se referir aCódigos de idiomas ISO 639Para encontrar o código apropriado para um idioma específico.

Para adicionar um novo idioma:

  • Criar um novo diretório nosrc/lib/i18n/localescaminho com o código de idioma apropriado como seu nome. Por exemplo, se você estiver adicionando traduções para a Espanha (Espanha), crie um novo diretório nomeadoes-ES
  • Copie os arquivos de tradução do American English (s) (s)en-USdiretório emsrc/lib/i18n/locale) para este novo diretório e atualize os valores da string no formato JSON, de acordo com o seu idioma. Certifique -se de preservar a estrutura do objeto JSON.
  • Adicione o código do idioma e seu respectivo título ao arquivo de idiomas emsrc/lib/i18n/locales/languages.json

🤔 Perguntas e feedback

Tem perguntas ou feedback? Junte -se ao nossoComunidade Discordou abrir um problema. Estamos aqui para ajudar!

🚨 Questões de relatórios

Notou algo fora? Tem uma ideia? Verifique nossoGuia de problemasPara ver se já foi relatado ou sugerido. Caso contrário, sinta -se à vontade para abrir um novo problema. Ao relatar um problema, siga nossos modelos de problema. Esses modelos são projetados para garantir que todos os detalhes necessários sejam fornecidos desde o início, permitindo -nos abordar suas preocupações com mais eficiência.

importante

  • Conformidade com o modelo:Esteja ciente de que a falha em seguir o modelo de problema fornecido ou não fornecer as informações solicitadas provavelmente resultará no fechamento do seu problema sem mais consideração. Essa abordagem é fundamental para manter a capacidade de gerenciamento e integridade do rastreamento de problemas.

  • Detalhe é chave:Para garantir que seu problema seja entendido e pode ser efetivamente abordado, é imperativo incluir detalhes abrangentes. As descrições devem ser claras, incluindo etapas para reproduzir, resultados esperados e resultados reais. A falta de detalhes suficientes pode dificultar nossa capacidade de resolver seu problema.

🧭 Escopo de apoio

Percebemos um aumento nas questões não relacionadas diretamente ao WebUI, mas ao ambiente em que foi executado, especialmente as configurações do Docker. Enquanto nos esforçamos para apoiar a implantação do Docker, a compreensão dos fundamentos do Docker é crucial para uma experiência suave.

  • Suporte a implantação do Docker: Nullcore suporta a implantação do Docker. A familiaridade com o Docker é assumida. Para o básico do Docker, consulte odocumentação oficial do Docker

  • Configurações avançadas: A configuração de proxies reversos para HTTPS e o gerenciamento de implantações do Docker requer conhecimento fundamental. Existem inúmeros recursos on -line disponíveis para aprender essas habilidades. Garantir que você tenha esse conhecimento melhorará muito sua experiência com WebUI aberto e projetos similares.

🙏 Obrigado!

Suas contribuições, grandes ou pequenas, causam um impacto significativo no webui aberto. Estamos animados para ver o que você traz para o projeto!

Juntos, vamos criar uma ferramenta ainda mais poderosa para a comunidade. 🌟