Usare più spesso i moduli segnaposto negli argomenti della documentazione?

Mi ha fatto pensare che meta sia, in parte, una piattaforma di documentazione.

La ricerca di example.discourse.com nella documentazione restituisce 46 risultati (e altri argomenti potrebbero utilizzare un altro dominio).

Questi argomenti potrebbero beneficiare dei placeholder. Esempio singolo di un argomento con molte menzioni di discourse.example.com: Discourse Doc Categories

Che ne dici di usare placeholder-forms su quegli argomenti?

4 Mi Piace

Sono d’accordo al 100% @Canapin! Sono un grande fan del componente placeholder-forms e lo uso su tutti i miei Discourse personali e aziendali, per la documentazione, la creazione di Runbook e per semi-automatizzare processi che non sono ancora pronti per uno script Bash.

Ecco un esempio che utilizza un Placeholder Publishing a Material for MkDocs site to Azure, with automatic branch/PR preview deployments - blog - Baw Medical Ltd

Mi piacerebbe vedere articoli in Documentation > Self-Hosting e Community wiki > Sysadmins utilizzare i placeholder ovunque ci sia del testo/comando da usare che necessiti di personalizzazione in tempo reale con l’input dell’utente.

3 Mi Piace

Mi piace anche il componente segnaposto. Use a subfolder (path prefix) to serve Discourse with multiple servers sharing a domain è un esempio in cui è già utilizzato, e il segnaposto funziona anche nella traduzione automatica (almeno in tedesco; ero un po’ preoccupato che l’IA potesse rompere la formattazione).

Vorrei anche vedere l’icona di Discourse utilizzata più spesso invece di minuscole schermate di un’icona o l’uso di un emoji dall’aspetto simile.

2 Mi Piace