Nuevas casas para la documentación oficial y comunitaria

Me complace anunciar algunas actualizaciones sobre cómo manejamos la documentación para garantizar la claridad y la colaboración, al tiempo que mantenemos la calidad de la información proporcionada. Sigue leyendo para comprender cómo funciona nuestra nueva configuración de documentación.

:writing_hand: Documentación oficial

Hemos actualizado la categoría Documentation para dedicarla exclusivamente a la documentación oficial. Esto significa que todo el contenido de sus subcategorías es mantenido por miembros del equipo de Discourse, lo que garantiza que la información sea precisa y esté actualizada. Si buscas las guías y referencias más autorizadas, ¡este es el lugar!

¿Por qué solo miembros del equipo?

Restringir la creación y edición de la documentación oficial a nuestro equipo garantiza la coherencia y la fiabilidad. Nuestro objetivo es proporcionar recursos precisos y bien mantenidos para todos, desde usuarios nuevos hasta desarrolladores experimentados. Todos los miembros de la comunidad aún pueden responder a estos temas para discutir el contenido o sugerir cambios.

:people_hugging: Wiki de la comunidad

¡No te preocupes, todavía hay mucho espacio para tus contribuciones! Toda la documentación contribuida por la comunidad ahora se puede encontrar en la categoría Community wiki. Aquí es donde se unen la experiencia, los consejos y el conocimiento colectivo de nuestra vibrante comunidad.

¿Quién puede contribuir?

Los usuarios con Nivel de Confianza 2 o superior tienen el poder de crear y editar temas en Community wiki. Esto permite a los usuarios experimentados compartir sus conocimientos, añadiendo riqueza y diversidad a nuestros recursos comunitarios. También significa que los miembros de confianza de la comunidad pueden editar cualquier documentación comunitaria que encuentren incorrecta o desactualizada.

:question: ¿Por qué este cambio?

Esta política está diseñada para equilibrar la necesidad de una documentación oficial y mantenida con las valiosas aportaciones que proporciona nuestra comunidad. También ofrece una estructura clara para los usuarios que buscan información, ya sea que necesiten orientación oficial o asesoramiento de la comunidad.

Valoramos las contribuciones de todos ustedes, y creemos que el traslado a un espacio dedicado para sus contribuciones de documentación les ayudará a prosperar y a recibir la atención que merecen.

:derek_pointing: ¡Te necesitamos!

La wiki de la comunidad ya tiene una ventaja para ser un espacio sólido, impulsado por la comunidad, para el aprendizaje y el intercambio de conocimientos, y nos encantaría contar con más de sus aportaciones. Si tienes excelentes tutoriales, configuraciones o consejos, ¡Community wiki espera tus contribuciones!


Puedes encontrar esta política de documentación en su hogar permanente aquí:

10 Me gusta

¿Puedo saber qué pasará con la insignia de Scribe?

4 Me gusta

¿Hay una forma sencilla de buscar en ambas fuentes de documentación simultáneamente? Soy consciente de que puedo buscar en varias categorías, pero eso es más engorroso que simplemente añadir #documentation con la ayuda de autocompletar.

Creo que puedo usar in:docs en su lugar, ¿porque ambas categorías se añaden a eso? in:kb que también funcionó para Discourse Docs no parece funcionar.

¿Y cómo funciona para las subcategorías? Por ejemplo, ¿cómo busco toda la información escrita para los usuarios? ¿Puedo buscar en #community-wiki:users y #documentation:using-discourse al mismo tiempo?

5 Me gusta

Un ejemplo de etiqueta clásica. Pero… entonces habría una cantidad tan masiva de etiquetas que es casi imposible de gestionar.

3 Me gusta

La insignia Scribe se ha actualizado para cubrir las contribuciones a la wiki de la comunidad :slight_smile:

3 Me gusta

Sí, puedes usar in:docs y buscará temas en Documentation y Community wiki al mismo tiempo.

La búsqueda incluirá temas en las subcategorías, por lo que ya forman parte de los resultados.

Para eso, necesitarías especificar categories:users,using-discourse en la búsqueda.

2 Me gusta

Pero todas esas necesitan un conocimiento bastante profundo de Discourse, ya que ninguna de ellas está soportada en la interfaz de búsqueda (avanzada).
¿No debería la documentación ser lo más fácil de buscar posible?

5 Me gusta

Creo que esto resalta las cosas que podemos mejorar en la interfaz de usuario de Discourse. En particular, permitir la selección de múltiples categorías en la búsqueda avanzada, entre otras cosas.

¡Esto presenta una gran oportunidad y una motivación adicional para trabajar en actualizaciones como esa, así que veremos qué podemos hacer allí! Discutiremos esto y volveré aquí con cualquier actualización.

4 Me gusta