Update instructions for creating Resource objects#12114
Conversation
Clarify instructions for creating a new Resource object in the Inspector.
|
I'm not sure this is needed or if we should really make this so verbose and explicit here, this is already covered in the introduction so I doubt anyone will be confused by this if they've read things that anyone should have read when looking at this part of the documentation |
|
i guess my question is: is the editor introduction a standard prerequisite for other sections of the documentation? if not, i think it is a good addition. You are right about it being verbose. There is probably a better way to word it. maybe: Create a new Resource object in the Inspector by clicking the top left icon. |
|
Yes people are expected to have read the introduction, I do not believe we should write the documentation for the case where users haven't read the basics, otherwise we'll bloat the text with obvious things Have anyone actually reported issues with this? |
This is the kind of overly-specific details that are prone to become invalidated in the future, turning what would look helpful in the moment into confusing instructions that don't quite match the current editor. Because they're a big maintenance burden, there's an on-going effort to minimize these cases, so this PR doesn't quite help as much as one may think. |
Clarify instructions for creating a new Resource object in the Inspector.