There are kinda two disciplines here, writing something that tries to convey a complex concept is important, but it's also important to be able to tersely descr

There are kinda two disciplines here, writing something that tries to convey a complex concept is important, but it's also important to be able to tersely describe a problem, and use correct, agreed upon language to do it. Compare: Wrong error message shows on Xm-z pages username input. Xm-z page, username input, Error message incorrect. I would argue that having agreed upon naming, and explicit syntax for how to describe issues/improvements in-between your team members is almost more important than being a good writer. The bottom sentence isn't even grammatically correct.