Naming guidelines

I had a brief look at some of the docs pages, and noticed some very curious naming practices. Even just looking at the Timeline page, I found some odd language:

  • ‘Player Controls’ (Should be Transport Controls)
  • ‘Time Cursor’ (Should be Playhead)

These are just two examples, but the current names here seem entirely foreign, and makes reading the manual quite difficult. Since I only looked at one page, I would expect to find other odd examples elsewhere.

This lead me to think: what are the guidelines here?

I think the guideline should be that the naming follows the Blender interface names and tooltips. For everything that is not covered by that, I guess it’s just a matter of convention in the manual.