Resumen
Este tema de documentación cubre cómo escribir una solicitud de característica en Discourse: Una guía paso a paso.
Paso 1: Antes de empezar
¿Así que tienes una gran idea para una característica de Discourse? ¡Eso es fantástico! Aquí te mostramos cómo puedes compartirla con el equipo y la comunidad de manera efectiva. Antes de enviar una solicitud de característica, tómate un momento para buscar discusiones existentes y ver si tu idea ya ha sido sugerida o implementada. Puedes hacerlo de varias maneras:
- Buscando en la categoría Feature
- Haciendo clic en el ícono
en la esquina superior derecha de la página para abrir la búsqueda. Puedes usar filtros avanzados para filtrar por categoría y etiqueta. - Revisando temas con la etiqueta pr-welcome - Un PR es una solicitud de extracción (pull request) en GitHub: una forma en que los desarrolladores introducen código nuevo en un proyecto.
- Revisando temas con la etiqueta completed
- Buscando en las categorías Plugin y Theme component
Si tu sugerencia de característica ya está listada, puedes apoyarla votando por ella para hacer sus solicitudes más prominentes, dándole “me gusta” y respondiendo con ideas o casos de uso adicionales, para comunicar mejor su utilidad y por qué la característica debería agregarse.
¿No encuentras ninguna mención de tu idea? Entonces puedes crear una solicitud de característica.
Paso 2: Lo básico
Título
Es importante que los títulos de los temas sean informativos, pero al mismo tiempo no demasiado largos. El alcance de la solicitud debe ser fácilmente identificable de un vistazo.
Categoría
Al crear un nuevo tema, por favor selecciona la categoría Feature.
Etiqueta
Las etiquetas se utilizan para agrupar y clasificar características, por lo tanto, para mantener organizadas las solicitudes, etiquetar tu tema apropiadamente es muy útil para fines de seguimiento. Por ejemplo, todo lo relacionado con el plugin chat se mantiene junto bajo una sola etiqueta.
Paso 3: Escribiendo tu solicitud
Escribir una buena solicitud de característica es importante, ayuda al equipo de Discourse a identificar rápidamente las áreas que podrían necesitar mejoras.
Recuerda, al crear una solicitud de característica, estás tratando de proponer tu idea y convencer a la gente de que tu idea para una característica está bien fundamentada. Explica por qué quieres que tu característica se agregue: a la comunidad, a ti mismo y al Equipo.
En el cuerpo de tu tema, establece concisamente la característica que estás solicitando. Sé específico y descriptivo, evita ser vago o abierto.
Proporcionar contexto y explicación
Proporciona contexto y explicación para tu solicitud de característica.
- Una descripción clara de la característica que estás solicitando
- Incluye el problema o los casos de uso de tu lucha actual y cómo tu característica lo resolvería
- Cualquier información de fondo o investigación relevante que hayas realizado
Proporcionar ejemplos y capturas de pantalla (Opcional)
Si es aplicable, proporciona ejemplos, maquetas o capturas de pantalla para ayudar a ilustrar tu solicitud de característica para que otros puedan visualizar fácilmente tu idea.
Interactuar con la comunidad
Una vez que hayas creado tu solicitud de característica, interactúa con los miembros respondiendo preguntas y comentarios. Esto ayudará a las posibilidades de que tu solicitud sea considerada.
Qué esperar a continuación
Después de enviar tu solicitud de característica, será revisada por la comunidad y el Equipo de Discourse. Puedes esperar:
- Comentarios y discusión de la comunidad
- Una respuesta del personal de Discourse indicando si tu solicitud es factible y está en consideración
- Posible implementación de tu solicitud de característica en una futura actualización
¿Quieres asegurarte de que tu característica se haga?
En algunos casos, las solicitudes de características pueden no ser adecuadas para el núcleo. Puedes leer cómo se toman las decisiones sobre características. Si no puedes desarrollar la característica tú mismo, todavía hay maneras de aumentar las posibilidades de que se realice.
Conviértete en un cliente de discourse.org
Si deseas financiar el desarrollo alojando sitios con nosotros, siempre priorizamos las solicitudes de los clientes en nuestro cronograma de desarrollo; esa es una forma de conseguirlo más rápido. Los clientes empresariales pueden solicitar características personalizadas (generalmente en forma de plugin) al equipo principal a una tarifa por hora.
Patrocinar una tarea “pr-welcome”
Tenemos una lista completa de temas pr-welcome. Estas son tareas que nos encantaría ver completadas, pero actualmente no tenemos ancho de banda para trabajar en ellas nosotros mismos. Patrocinar a alguien para que trabaje en estas tareas es una excelente manera de involucrarse y cualquier contribución a Discourse es muy apreciada.
Ofrecer trabajo pagado en el Marketplace
Si necesitas un plugin que es crítico para tu negocio, anuncia una asignación pagada en la categoría Marketplace. Proporciona tantos detalles como sea posible, incluyendo capturas de pantalla y presupuesto. También puedes encontrar freelancers que ofrezcan microservicios estandarizados como “instalación única” o “tema personalizado”.
General
Qué hacer y qué no hacer en general
Hacer
- Mantén tu solicitud concisa y enfocada en una sola característica
- Evita hacer suposiciones sobre la implementación o detalles técnicos
- Muestra disposición a comprometerte y adaptar tu idea basándote en los comentarios de la comunidad
No hacer
- Incluir más de una característica por tema
- Dejar a otros cuestionando el alcance de tu solicitud
Preguntas frecuentes
P: ¿Qué pasa si no tengo tiempo para crear una solicitud de característica detallada?
R: Si en el momento no puedes crear una solicitud detallada, reflexiona sobre lo que quieres decir e inténtalo de nuevo más tarde. Esto asegura que presentes tu mejor argumento, lo que resulta en una mayor probabilidad de que otros apoyen tu solicitud y que se agregue.
P: ¿Dónde debo publicar mi solicitud de característica?
R: Utiliza la categoría apropiada: las solicitudes de características deben ir a la categoría Feature.
P: ¿Qué pasa si no estoy seguro de qué etiqueta usar para mi solicitud?
R: Aunque las etiquetas coinciden con los nombres de plugins y componentes temáticos para facilitar su uso, un miembro del Equipo o un Regular agregará una etiqueta apropiada a tu tema si se deja en blanco.
Sé respetuoso y de mente abierta en tu solicitud. Evita usar la solicitud de característica para expresar frustración. Cualquier lenguaje o comportamiento inapropiado puede resultar en que tu solicitud se retrase o se ignore.
Recursos adicionales
- Categorías: Feature, Marketplace, Plugin, Plugin > Extras, Theme, Theme component
- Etiquetas: current-projects, release-notes, pr-welcome, planned
- https://meta.stackexchange.com/questions/258136/how-do-i-write-a-good-feature-request
- How do we decide what goes into each release of Discourse?
- Discourse pricing | Discourse - Civilized Discussion
