¿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?

2 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.

2 Me gusta