Use more often placeholder forms in documentation topics?

Made me think that meta is, partially, a documentation platform.

Searching for example.discourse.com in the documentation returns 46 results (and other topics may use another domain).

Those topics could benefit from placeholders. Single example of a topic with many discourse.example.com mentions: Discourse Doc Categories

What about using placeholder-forms on those topics?

2 likes

100% agree @Canapin! I’m a big fan of the placeholder-forms component and I use it on all my personal and business Discourses, for documentation, creating Runbooks, and for semi-automating processes which aren’t ready for a Bash script.

Here’s an example that uses a Placeholder Publishing a Material for MkDocs site to Azure, with automatic branch/PR preview deployments - blog - Baw Medical Ltd

I’d love to see articles in Documentation > Self-Hosting and Community wiki > Sysadmins use placeholders wherever there is some text/command to use which needs real-time customisation with user input.

2 likes