¿Usar más a menudo formularios de marcador de posición en temas de documentación?

Me hizo pensar que meta es, parcialmente, una plataforma de documentación.

Buscar example.discourse.com en la documentación devuelve 46 resultados (y otros temas pueden usar otro dominio).

Esos temas podrían beneficiarse de los formularios de marcador de posición (placeholders). Ejemplo único de un tema con muchas menciones de discourse.example.com: Discourse Doc Categories

¿Qué tal usar placeholder-forms en esos temas?

4 Me gusta

¡Estoy 100% de acuerdo @Canapin! Soy un gran admirador del componente placeholder-forms y lo uso en todos mis Discourse personales y de negocios, para documentación, creación de Runbooks y para semi-automatizar procesos que no están listos para un script Bash.

Aquí hay un ejemplo que usa un Placeholder Publishing a Material for MkDocs site to Azure, with automatic branch/PR preview deployments - blog - Baw Medical Ltd

Me encantaría ver artículos en Documentation > Self-Hosting y Community wiki > Sysadmins que utilicen placeholders dondequiera que haya algún texto/comando que deba personalizarse en tiempo real con la entrada del usuario.

3 Me gusta

También me gusta el componente de marcador de posición. Use a subfolder (path prefix) to serve Discourse with multiple servers sharing a domain es un ejemplo donde ya se utiliza, y el marcador de posición también funciona en la traducción automática (al menos en alemán; tenía un poco de miedo de que la IA pudiera romper el formato).

También me gustaría ver el icono de Discourse usándose más a menudo en lugar de pequeñas capturas de pantalla de un icono o usando un emoji que se parezca.

2 Me gusta