Page MenuHome

UI: Fix capitalization
ClosedPublic

Authored by Yevgeny Makarov (jenkm) on Jul 19 2020, 5:56 PM.

Details

Summary

Fix capitalization.

Not sure about "From", but it seems to be more common with a capital letter in Blender.

Diff Detail

Repository
rB Blender

Event Timeline

Yevgeny Makarov (jenkm) requested review of this revision.Jul 19 2020, 5:56 PM
Yevgeny Makarov (jenkm) created this revision.

Online converters to title case say the "from" should remain lower case. Everything else seems fine too.

This revision is now accepted and ready to land.Jul 19 2020, 10:22 PM

"Project From View" - in AP, APA, and New York Times style.
"Project from View" - in Chicago, MLA, and Wikipedia style.

https://titlecaseconverter.com/blog/is-from-capitalized/

Currently in Blender, next to each other:

  • "Project From View"
  • "Project from View (Bounds)"

It would be nice to just pick an official style guide so we can point to something as authoritative in cases like this. AP style would be my pick.

Another one in this set that, I think, differs between styles is “Convert To”. At least for AP the final To” is capitalized while it would not be when inside of “Convert to Mesh”

I tend to follow guidelines from MLA and Wikipedia, MLA because that is what I am personal use to, and Wikipedia because of its "Open Content" culture.

Used lowercase for "from".
There are still a few "From" in addons.

Interestingly, the guidelines say every word should be capitalized. However we don't follow this at all in practice, as one can easily confirm by opening a few menus.

I'd propose changing to a clearly defined title case then. I don't have a strong opinion on which, but my proposal would be the MLA style, which I think is simpler than the Wikipedia style and defines rules for hyphenated terms. MLA and Wikipedia seem almost identical though, except for few corner cases.
https://titlecaseconverter.com/rules/#MLA

+1 from me on switching to MLA standard for title case standardization.

Opened a task to discuss the title case format T79589. I'll wait for this to be decided before committing this patch. I see a few more changes in this patch that depend on the exact style we settle on.

source/blender/editors/mesh/editmesh_select_similar.c
67

If these edges are connected to each other then they should be "Connected Edges", and if something is countable we should use "Number" rather than "Amount", which is used for uncountable values. So you have a number of bottles, but an amount of water.

In short, this should be "Number of Connected Edges". And above "Number of Adjacent Faces"

@Julian Eisel (Severin) - Looking at a couple of these patches, they do seem to conform nicely to MLA style, which I assume is what we have agreed on.

A couple things I noticed that might be nice to add to our docs though:

  • Usage of "and" versus "&" - not sure what we prefer but should pick one. Probably "and"
  • Usage of "Number" for countable things, "Amount" for mass nouns. General rule is use "Amount" for nouns that do not have a plural, "number" everywhere else.

Usage of "and" versus "&" - not sure what we prefer but should pick one. Probably "and"

Ampersand should not be used in natural language so it shouldn't be used in tooltips in this case use and. Using "and" is for engaging and explaining. Ampersands should be used in areas that are intended for indications such as labels and menu items. This makes them more concise and usually the user is not exactly reading the text but usually quickly glancing for key identifiable features, using the word "and" here is confusing because our brain wants ro read it instead of identifying "&" which is depicted in our brains more like a picture.