Nuevos hogares para la documentación oficial y comunitaria

¡Estoy emocionado de anunciar algunas actualizaciones sobre cómo gestionamos la documentación para garantizar claridad y colaboración, manteniendo al mismo tiempo la calidad de la información proporcionada. Sigue leyendo para entender cómo funciona nuestra nueva configuración de documentación.

:writing_hand: Documentación oficial

Hemos actualizado la categoría Documentation para que esté dedicada exclusivamente a la documentación oficial. Esto significa que todo el contenido en sus subcategorías es mantenido por miembros del equipo de Discourse, asegurando 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 consistencia y 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 comunitaria

¡No te preocupes, también hay mucho espacio para tus contribuciones! Toda la documentación contribuida por la comunidad ahora se encuentra en la categoría Wiki. Aquí es donde convergen 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 la capacidad de crear y editar temas en Wiki. Esto empodera a los usuarios experimentados para compartir sus conocimientos, añadiendo riqueza y diversidad a los recursos de nuestra comunidad. 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 documentación oficial y mantenida con la valiosa aportación 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 consejos de la comunidad.

Valoramos las contribuciones de todos ustedes, y creemos que el paso a un espacio dedicado para sus contribuciones de documentación ayudará a que prosperen y reciban la atención que merecen.

:derek_pointing: ¡Te necesitamos!

La wiki comunitaria ya tiene una ventaja al ser un espacio robusto, impulsado por la comunidad, para el aprendizaje y el intercambio de conocimientos, y nos encantaría contar con más de tu aportación. Si tienes excelentes tutoriales, configuraciones o consejos, ¡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 Wiki al mismo tiempo.

La búsqueda incluirá temas en las subcategorías, por lo que estas 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