Blender 4.1 is coming in two weeks, and the blender devs are focused on that at the moment. I've reached out to them in the chat (#docs, in blender.chat) and…
I can't see anything in red. Are the parts supposed to be in red the ones inside single-quotes?
To be fair, /usr/local is a pretty popular location as well.
These instructions have been long due, so thanks for that.
I guess everything under /usr/share/icons/ is freedesktop-compliant, but based on what other apps on my machine do, I'd go one level further still: /usr/share/icons/hicolor/scalable/apps/.
"This may be true"? Perhaps "This should work in any modern..."
The formatting makes it seem like this is another command, not an output from the previous command. You could put the prompt sign $ before every command, or write about the expected output here in text, out of the code-block, or something else. I'd favour the first option.
Is this needed? Mine seem to have worked out-of-the-box.
Is this necessary? If so, perhaps it'd better be addressed in the preceding text ("if you happen not to have /opt, then you're free to create it/use the appropriate folder for your setup.").
You can substitute the existing link in a single command, with ln's -Tf flags:
Should this step be placed somewhere else?