¡Bienvenido! Estamos aquí para ayudarte. Esta guía te mostrará cómo obtener soporte para cualquier proyecto de AmoxcalliDev.
Para obtener ayuda más rápido, te recomendamos:
-
🔍 Busca primero: Es probable que alguien ya haya tenido la misma pregunta
- Revisa los Issues cerrados del repositorio
- Busca en las Discussions
- Consulta la documentación del proyecto
-
📖 Lee la documentación:
- README.md del proyecto
- Wiki (si existe)
- Comentarios en el código
-
🐛 Identifica si es un bug:
- Si crees que encontraste un bug, reporta un issue
- Si es una vulnerabilidad de seguridad, lee nuestra Política de Seguridad
¿Para qué? Preguntas generales, ideas, debates técnicos
Ventajas:
- ✅ La comunidad puede ayudar
- ✅ Las respuestas quedan para futuros usuarios
- ✅ Puedes marcar respuestas como solución
Cómo usarlo:
- Ve a las Discussions de AmoxcalliDev
- Busca si tu pregunta ya fue respondida
- Si no, crea una nueva Discussion
Categorías disponibles:
- 💡 Q&A: Preguntas y respuestas
- 💭 Ideas: Propuestas y sugerencias
- 🎉 Show and Tell: Muestra lo que hiciste
- 🗨️ General: Discusión general
¿Para qué? Reportar bugs, solicitar funcionalidades, problemas específicos
NO uses Issues para:
- ❌ Preguntas de "¿cómo hago X?"
- ❌ Soporte general
- ❌ Discusiones abiertas
Cómo usarlo:
- Ve al repositorio específico
- Click en "Issues"
- Click en "New Issue"
- Elige el template apropiado (Bug Report o Feature Request)
¿Para qué? Conversaciones en tiempo real, ayuda rápida, networking
Canales que tendremos:
- 💬 #general: Chat general
- 🆘 #ayuda: Soporte técnico
- 💻 #showcase: Muestra tus proyectos
- 🎯 #contribuciones: Coordinación de contribuciones
Estado: 🚧 Próximamente - Estaremos anunciando cuando esté disponible
¿Para qué? Asuntos que no pueden ser públicos
📧 Contactos:
- General: contact@amoxcalli.dev
- Seguridad: security@amoxcalli.dev
- Código de Conducta: conduct@amoxcalli.dev
Tiempo de respuesta: 2-5 días hábiles
Un bug es cuando el código no funciona como se espera. Antes de reportar:
- ✅ Verifica que estás usando la versión más reciente
- ✅ Revisa que no sea un problema de configuración
- ✅ Busca si ya fue reportado
- Ve al repositorio específico del proyecto
- Click en "Issues" > "New Issue"
- Selecciona "Bug Report"
- Llena el template con:
- Descripción clara del bug
- Pasos para reproducir
- Comportamiento esperado vs actual
- Capturas de pantalla (si aplica)
- Información del entorno (OS, versión, navegador, etc.)
## Descripción
El botón de login no responde cuando se hace clic en Safari
## Pasos para Reproducir
1. Abre la app en Safari 17+
2. Navega a /login
3. Haz clic en "Iniciar Sesión"
4. Nada sucede
## Esperado
Debería redirigir a la página de autenticación
## Actual
El botón no responde, no hay errores en consola
## Entorno
- OS: macOS Sonoma 14.1
- Navegador: Safari 17.0
- Versión: v1.2.3¡Genial! Nos encanta escuchar ideas de la comunidad.
- 🔍 Busca si alguien ya lo sugirió
- 💭 Piensa en el caso de uso
- 🎯 Considera si beneficia a la comunidad
- Ve al repositorio específico
- Click en "Issues" > "New Issue"
- Selecciona "Feature Request"
- Describe:
- El problema que resuelve
- La solución propuesta
- Alternativas consideradas
- Contexto adicional
Cada proyecto tiene su propia documentación:
- README.md: Introducción y guía rápida
- Wiki: Documentación detallada (cuando existe)
- Código comentado: Explicaciones inline
Depende del canal:
- Discussions: 1-3 días (comunidad + mantenedores)
- Issues: 2-5 días (mantenedores)
- Discord: Minutos a horas (comunidad) (cuando esté disponible)
- Email: 2-5 días hábiles
¡Por supuesto! AmoxcalliDev es una comunidad mexicana. Puedes usar español o inglés.
No ofrecemos soporte pagado para proyectos open source. Sin embargo, si necesitas:
- Consultoría
- Desarrollo personalizado
- Soporte empresarial
Contacta a ByFruitsDev para servicios comerciales.
¡Excelente! Sigue estos pasos:
- Lee nuestra Guía de Contribución
- Encuentra o crea un issue sobre documentación
- Haz un fork y mejora la docs
- Envía un Pull Request
Si necesitas algo específico y urgente:
- Para proyectos open source: Puedes implementarlo tú mismo y contribuirlo
- Para proyectos comerciales: Contacta a ByFruitsDev
✅ Haz esto:
- Sé específico y claro
- Incluye código relevante (usa code blocks)
- Muestra lo que ya intentaste
- Proporciona contexto suficiente
- Usa un título descriptivo
- Agradece cuando recibas ayuda
❌ Evita esto:
- "No funciona, ayuda"
- Código sin formato
- Capturas de pantalla de código (usa texto)
- Preguntas muy amplias
- Múltiples preguntas no relacionadas en un solo post
Título: ¿Cómo validar emails con regex en el módulo de auth?
Descripción:
Estoy intentando agregar validación de email en el formulario de registro,
pero no estoy seguro de cuál es la mejor práctica en este proyecto.
Lo que intenté:
const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
if (!emailRegex.test(email)) {
// error
}Pregunta:
- ¿Este proyecto usa alguna librería específica para validación?
- ¿O debo usar regex nativo?
Contexto:
- Repo: AmoxcalliDev/proyecto-auth
- Archivo: src/validators/user.js
- GitHub Discussions
- Guía de Contribución
- README de cada proyecto
- 🌮 Tacos && Code: Sessions de coding (próximamente)
- 💻 Code Reviews: Aprende revisando PRs
- 📚 Wiki: Documentación colaborativa
Solo para:
- 🔒 Vulnerabilidades de seguridad (ver política)
⚠️ Violaciones del código de conducta- 📧 Asuntos privados que no pueden ser públicos
- 📧 contact@amoxcalli.dev
- 💬 Discord (próximamente)
- 💬 GitHub Discussions (para preguntas públicas)
Somos una comunidad abierta y amigable. Valores importantes:
- 🤝 Respeto: Todos merecen respeto
- 📚 Aprendizaje: No hay preguntas tontas
- 💪 Colaboración: Nos ayudamos mutuamente
- 🎯 Calidad: Buscamos la excelencia
Lee nuestro Código de Conducta para más información.
"Ninguna pregunta es tonta, solo oportunidades de aprender"
💚 Hecho con amor desde México 🇲🇽
¿Necesitas ayuda? ¡No dudes en preguntar!
