Error in the "Getting Better Support" post?

Other Website and services
1

I believe I found an error in How to Get Better Results when Posting About Problems

  • If console output is not in English preface commands with LC_ALL=C prefix - example:sudo LC_ALL=C dnf upgradeThis is because English is the common language used by all of our developers and package maintainers so this makes it easier for all to understand posted code.

Shouldn’t this command be dnf distro-sync, just for consistency to avoid confusing new folks?

1 Like
2

On ROME, yes. On Rock, no.

1 Like
3

The important thing to get out of that is that the prefix LC_ALL=C works with any command and it does help immensely for those trying to help a user with a technical problem.

1 Like
4

I didn’t realize Rock used a different upgrade command as I’ve not used it. Apologies for the noise.

5

Rock users can use sudo dnf dsync --refresh also. IMO OM should quit recommending 2 different commands. There is word for doing things like that…

6

Having once taught technical writing, I agree that using consistent terminology is very important.

I’m particularly sensitive about documentation at the moment as I’ve been working on rsyslog for my day job since late last fall, and the docs are frustratingly incomplete, inconsistant, and out-of-date.

7

Full disclosure: In criticizing OM folks on this I am partly criticizing my own past actions as I am one of the OM contributors. Before this year we had so few users such thing were not of major consequence. Now we need to do better, and be more consistent. This is easy to say but not so easy to do when the contributor group is very small and all part-time, unpaid, volunteers. But over time we will get better.

4 Likes
8

I am hoping to be able to contribute more once my work settles down. I just joined about 5 months ago and we have some big projects going on. In the meantime, I will answer questions here when I have the time.

Though I’m not a developer, I used to build packages many, many years ago back before package repositories were a thing. And I can of course work on documentation. I actually prefer doing “clean up” as you say over writing things from scratch.

1 Like
9

It’s an example.

Anyway to avoid possible confusion I edited to:
sudo LC_ALL=C dnf <your_command>

Thanks for reporting.

1 Like