Documentación en un foro de discusión

Sería genial si pudieras iniciar un tema de Site feedback y explicar un poco más esto. :+1: Tenemos muchos sitios que usan una categoría como base de conocimiento, al igual que nosotros, y siempre estamos buscando formas de mejorar si tienes alguna idea o comentario que ofrecer.

Gracias. Me refería principalmente al hecho de que la “documentación basada en discusiones” suele ser un trabajo arduo para los nuevos usuarios, ya que a menudo implica leer una publicación seguida de un hilo de discusión que actualiza o modifica la publicación original. Pero hablo por mí mismo, por supuesto, y puedo ver que otros podrían no verlo de esa manera :slight_smile:

1 me gusta

Sí, a mí tampoco me gusta eso. :slight_smile: Y las colas de respuestas largas a menudo pueden resultar desalentadoras en sí mismas. La idea aquí (aunque aprecio que a menudo hay un retraso) es mover toda la información relevante a la publicación original para no tener esa situación. También intentamos separar las discusiones distintas en temas separados (etiquetados, cuando podemos) para hacerlos más fáciles de buscar también. También tenemos algunos temporizadores de autodestrucción que eliminan las respuestas antiguas después de un cierto tiempo. Es un trabajo en progreso, pero esperamos que nos estemos moviendo en la dirección correcta. :slight_smile:

2 Me gusta

Sí. Creo que hasta cierto punto no se pueden evitar las confusiones, pero es bueno saber que lo intentas (aunque dudo que llegues a eliminar comentarios que se han incorporado a un OP editado posteriormente, que suele ser la principal pérdida de tiempo).

Pero mi punto original no era realmente sobre eso. Creo que me he dado cuenta un poco tarde de que, por supuesto, no eres un proyecto F/LOSS, por lo que es posible que no aprecies que gente como yo intente ofrecer “ayuda”.

1 me gusta

Agradecemos la documentación y los consejos creados por la comunidad. :+1:

El temporizador de autodetección es bastante indiscriminado, por lo que puede ser un arma de doble filo. :slight_smile: Pero la intención es separar la sugerencia de cambiar la documentación en un tema aparte para conservar el historial cuando sea necesario/útil. Es un proceso, digamos, ‘orgánico’, por lo que es posible que encuentres algunos/muchos ejemplos en los que no ha sido así. :slight_smile:

Aunque respondemos razonablemente si detectas algo y crees que debería cambiarse/mejorarse de alguna manera. :+1:

1 me gusta

Eso no es a lo que me refería, ¿miraste el enlace que proporcioné?

No te dirigí a la categoría de documentos, /docs es generado por el plugin discourse docs.

La interfaz es bastante diferente, más parecida a un sistema típico de gestión del conocimiento, con búsqueda y filtros enfocados. Omite las respuestas, que se agrupan periódicamente en la publicación original como puedes ver en los historiales de edición.

Gracias, pero no estoy seguro de cómo eso es relevante para la conversación que creí haber iniciado, así que lo ignoré, me temo. Me alegra saber que existe un plugin así, no me malinterpretes :slight_smile:

Según tu comentario de que la documentación no estaba en un formato adecuado o no se podía descubrir, compartí un enlace a la herramienta aquí en meta que presenta la documentación en un formato diferente e incluye funciones que ayudan a descubrirla.

Aprecio que, viniendo de un entorno de cartero, el enfoque diferente adoptado aquí puede que no te resulte familiar de inmediato. Como alguien que ha pasado gran parte de los últimos nueve años ofreciendo asistencia aquí en Meta, puedo asegurarte que es increíblemente útil tener la documentación más cerca de la discusión de soporte.

1 me gusta

Entiendo, disculpa mi malentendido.

Estoy perfectamente de acuerdo con que hagas lo que quieras. Simplemente tenía curiosidad por saber si apreciarías que enviara una PR al repositorio para agregar instrucciones de instalación complementarias. Veo que la respuesta es que no lo harías.

Así que me retiro y te agradezco tu indulgencia :slight_smile:

1 me gusta

Me gusta esa categoría de #documentación y la he usado a menudo. Estoy confundido porque no veo razones obvias por las que no sea ideal. :woman_shrugging:t2:

Hay mucha información útil allí y se agradecería enviar una contribución allí y probablemente sería útil para otros.