Tenemos un montón de guías; a veces @dax o @jomaxro comparten una guía de howto que no sabía que existía y ¡me deja impresionado!
También he notado que esto ocurre con muchos usuarios nuevos y administradores de comunidad en Discourse aquí en Meta. Así que, con el objetivo de resolver esto, @justin tuvo una idea genial: agrupar nuestras guías howto para ofrecer a todos un mejor punto de partida y, con suerte, lograr algo similar a https://support.teams.discourse.com/docs
¡Jaja, sí que los hay! Idealmente, si pudiéramos tener entre 6 y 12 tutoriales por categoría, sería genial. No buscamos categorizarlos a todos, sino solo los mejores que la gente podría estar buscando.
@osioke: una forma de abordar esto es buscar los tutoriales más vistos que se relacionen con estas categorías y seleccionar los 6-12 más vistos para etiquetarlos como tales. Sería un buen punto de partida, combinado con las sugerencias de @Benjamin_D aquí.
La ventaja de las etiquetas es que también podemos editarlas fácilmente a medida que avanzamos.
¡Gracias por compartir esto, @Benjamin_D! Una de las cosas con las que estaba luchando era cómo presentar y cómo pensar en la estructura; tu tabla aquí ayuda mucho.
Ahora estoy buscando expandir la agrupación de 3 a 6:
Primeros pasos
Configuración
Configuración avanzada
Contribuir
Configurando
Configuración avanzada
Y, como compartió @justin, mirando los más vistos, tengo los primeros 20:
Hmm, los artículos sobre configuración del inicio de sesión probablemente podrían tener su propia categoría, y es un subconjunto de “Primeros pasos” porque es una de las primeras cosas que quieres hacer en un sitio nuevo, si es que quieres hacerlo en absoluto.
No estoy seguro de que sea necesario mencionar multisite aquí o quizás el grupo de configuración avanzada podría incluir una advertencia, ¡búsqueda meta! Por ejemplo, esta publicación es muy útil pros-and-cons-of-a-multisite-installation.
Cierto, la lista se basa en las 20 más vistas, y la compartí para mostrar mi razonamiento sobre la organización. De ninguna manera es la lista final; debería haber sido un poco más claro
Me gustaría ver administración u operaciones como una categoría para las actividades continuas de administración y moderación. No encaja con la configuración ni es desarrollo/documentación (contribuir).
Asumo que el sitio de documentación de Discourse for Teams utiliza Discourse para todos los documentos. El problema con eso para un sitio de cómo hacer sobre Discourse, donde cualquier persona de la comunidad pueda participar, es la gestión de versiones y el seguimiento de todo. Estoy seguro de que usar Discourse para esto sería el método preferido, pero ¿podría sugerir un sitio Hugo o un sitio Jekyll, y que los documentos sean archivos en un repositorio de GitHub al que cualquiera pueda enviar solicitudes de extracción (PRs)? Si no te gusta ninguna de esas opciones, hay muchos más sistemas de documentación en repositorios de GitHub disponibles en diversas variantes.
Oh, el control de versiones funciona bastante bien en Discourse, incluso muy bien. Y si lo combinas con la seguridad de acceso por categorías, tendrás algo de lo que estamos orgullosos de usar
Solo por si acaso, he estado trabajando lentamente en la limpieza de #howto:sysadmin, verificando que cada uno esté actualizado y relevante, y luego moviéndolos a auto-delete-posts-after para ellos. Parece que la mayoría de esos se han categorizado aquí como configuración avanzada.
Totalmente de acuerdo. El multisitio es una configuración súper avanzada y no es algo que respaldemos mucho en Meta.
Así es. Discourse + el plugin Docs + algunas personalizaciones adicionales. Usar Discourse es nuestra preferencia para esto, pero también veo los beneficios de utilizar un sitio wiki/SSG.
Sería genial que los temas de “menor soporte” pudieran ir en su propia categoría claramente marcada.
Parece haber una mentalidad actual de que si algo está escrito aquí, se debe algún tipo de soporte.
También facilita abogar para que los usuarios prueben antes de actualizar, ya que estas funciones suelen ser más frágiles o estar menos probadas entre versiones.
Creo que el multisitio está bastante “soportado”, pero se espera que, si eliges ese camino, sepas que se requiere más de ti (por ejemplo, necesitas considerar qué significa rebuild app en varios contextos). Diría que es “avanzado”, pero no “muy muy avanzado”.
Estoy de acuerdo en que las categorías terciarias y las subcarpetas son “muy muy avanzadas”.
Quizás estoy pensando más en el uso de multisitio con Let’s Encrypt, que se ha roto repetidamente a lo largo de los años y, a veces, la documentación actualizada ha tardado semanas o meses en aparecer.
Ah, sí. Creo que probablemente es bastante estable ahora (creo que el último cambio tuvo que ver con cómo se manejaban las redirecciones en nginx), y tengo un Multisite Configuration with Let's Encrypt and no reverse proxy - Documentation - Literate Computing Support que tengo la intención de publicar aquí Realmente Pronto (fue el 2 de diciembre de 2020 cuando lo escribí y lo probé por última vez). Pero multisitio definitivamente es algo en lo que estás mayormente solo. No creo que tenga sentido a menos que tengas al menos 3 (¿quizás 10?) sitios, ya que parece que la mayoría de las personas que creen que lo quieren están tratando de funcionar con un solo droplet de 1 GB.
Lo que más me ayudaría sería que, en lugar de dedicar más esfuerzo a estructurar la categoría (cómo hacerlo) en sí, se le dé una mejor estructura a la documentación.
Agradezco mucho que el foro sea fluido para que los usuarios publiquen. Creo que, para ello, es fundamental tener categorías de nivel superior bien definidas y que los usuarios publiquen en la correcta. Sin embargo, cuando las subcategorías se vuelven complejas, y resulta importante que los usuarios publiquen en la subcategoría adecuada o busquen en la correcta, encuentro que esto resulta algo disruptivo.
Actualmente, prácticamente solo reflejan la configuración del foro en la documentación:
¿Por qué no permiten que el personal utilice etiquetas exclusivas para el equipo con el fin de organizar y estructurar la documentación, como ‘docs-getting-started’, ‘docs-setup’, con contenido de cualquier parte del foro? De esta manera, podrían crear una página de documentación que sea más que un simple espejo del foro, sino que tenga un índice de contenidos verdaderamente curado, como:
¡Esa es precisamente la idea aquí, @manuel! Estamos planeando crear algunas formas de filtrar fácilmente por estos tipos de tutoriales, pero conservando los filtros que ya existen en el plugin Docs. Organizar estos tutoriales en etiquetas específicas es el primer paso para empezar.
o quizás el grupo de configuración avanzada podría incluir una advertencia, ¡búsqueda meta! Por ejemplo, esta publicación es muy útil 
) y 
.
