Am 23.07.2022 um 08:33 schrieb Joe Zeff joe@zeff.us:
and the mention of a specific program name is more of a placeholder that can/must be adapted just like other file- oder variable names in the sample code.
And how many Linux newcomers do you think realize that?
All the texts I’m aware of describe it at the beginning and/or repeat it in the text again and again.
Nevertheless, what’s your specific suggestion? How should we do it this specifically in Fedora documentation? How can we accomplish this under the condition of good readability?
I’m the author of Fedora docs style guide currently under development, see https://docs.fedoraproject.org/en-US/fedora-docs/contributing/style-guide/ and some discussion at https://discussion.fedoraproject.org/t/fedora-documentation-style-guide-1st-...
So, please cheer up and contribute.