> Am 23.07.2022 um 08:33 schrieb Joe Zeff <j...@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-draft-proposal/39961

So, please cheer up and contribute.
_______________________________________________
users mailing list -- users@lists.fedoraproject.org
To unsubscribe send an email to users-le...@lists.fedoraproject.org
Fedora Code of Conduct: 
https://docs.fedoraproject.org/en-US/project/code-of-conduct/
List Guidelines: https://fedoraproject.org/wiki/Mailing_list_guidelines
List Archives: 
https://lists.fedoraproject.org/archives/list/users@lists.fedoraproject.org
Do not reply to spam on the list, report it: 
https://pagure.io/fedora-infrastructure

Reply via email to