godot icon indicating copy to clipboard operation
godot copied to clipboard

[TRACKER] Typos and UI Paper Cuts

Open RedMser opened this issue 1 year ago • 3 comments

As per https://github.com/godotengine/godot-proposals/issues/9648, this issue tracks tiny issues which can easily be fixed and are not opinionated changes. This includes:

  • A misspelling in the user interface or class reference
  • A misspelling in the code (comment, variable name, class name, etc. as long as it is not a breaking change)
  • Adding or tweaking the property hint of a property
  • Giving names to unnamed method arguments
  • Changing the "basic/advanced" status of Project Settings

It does NOT include any functional changes, such as refactoring or reordering code. Purpose of tracking these is NOT for users to make PRs for fixing them directly, but rather:

  1. For maintainers to periodically fix all of the listed issues in larger batches, instead of doing small PRs for individual issues.
  2. For contributors that are already touching code near a known issue, to fix it while they're at it.

A task list is used to keep track of how many issues there are, but you can simply remove the bullet points when done instead of checking them, to keep this tracker clean and re-usable.

Typos

  • [ ] core/object/script_language.cpp
    • typo: characacteristics -> characteristics
  • [ ] editor/plugins/visual_shader_editor_plugin.cpp at _setup_node function
    • code style: camelCase should be snake_case
  • [ ] scene/gui/code_edit.cpp
    • typo: all_ocurence -> all_occurrences (local variable)
  • [ ] doc/classes/SceneMultiplayer.xml
    • typo:
      -The callback to execute when when receiving authentication data
      +The callback to execute when receiving authentication data
      

Functional changes

  • [ ] core/string/translation.cpp inside of TranslationServer::setup()
    • Add property hint ProjectSettings::get_singleton()->set_custom_property_info(PropertyInfo(Variant::STRING, "internationalization/locale/test", PROPERTY_HINT_LOCALE_ID, ""));

Maintainers are free to edit this issue to add to the list or change wording. Other contributors are welcome to write comments and they'll be taken into account.

RedMser avatar May 03 '24 16:05 RedMser

Can you add this to the tracker?

https://github.com/godotengine/godot/blob/96a386f3c424af96d950ee5098b4b0e4907c9508/doc/classes/DisplayServer.xml#L1753

-Transient window is will be destroyed...
+Transient window will be destroyed...

LunarTides avatar Jun 05 '24 06:06 LunarTides

Grammar issues: Likely intended to be "...representing a GLTF accessor...": https://github.com/godotengine/godot/blob/96a386f3c424af96d950ee5098b4b0e4907c9508/modules/gltf/doc_classes/GLTFAccessor.xml#L7 Likely intended to be "...representing a GLTF bufferView...": https://github.com/godotengine/godot/blob/96a386f3c424af96d950ee5098b4b0e4907c9508/modules/gltf/doc_classes/GLTFBufferView.xml#L7

Edit: Addressed in https://github.com/godotengine/godot/pull/95578.

tetrapod00 avatar Aug 15 '24 06:08 tetrapod00

Many uses of camelCase instead of snake_case in this function: https://github.com/godotengine/godot/blob/e4e024ab88efe74677769395886bc1b09eccbac7/editor/plugins/visual_shader_editor_plugin.cpp#L3306

tetrapod00 avatar Sep 22 '24 18:09 tetrapod00

There are a lot of string concatenations that should be changed to vformat as suggested in the documentation. Maybe we should add this into the tracker as well?

EAinsley avatar Oct 09 '24 14:10 EAinsley

Maybe we should add this into the tracker as well?

Not sure if there is an easy way to find all these occurrences across the repository. But indeed these are the kind of changes that shouldn't be done as tiny PRs that change 1 place, but rather one large PR that fixes this on a broader scale, so it makes sense to do it together with tiny typo fixes like those listed here.

RedMser avatar Oct 09 '24 14:10 RedMser

One thing to search for would be: " + String it won't necessarily be very narrow or complete but it'd catch a lot I suspect, I'll take a look at some fixes myself

AThousandShips avatar Oct 09 '24 14:10 AThousandShips

That would be too laborious. It would be better if someone just fix a little bit when they saw those code while working on a big commit and commit them alongside.

EAinsley avatar Oct 09 '24 14:10 EAinsley

If it touches the area sure, but only then, but these changes are best handled systematically

AThousandShips avatar Oct 09 '24 14:10 AThousandShips

All currently listed typos / minor issues should be handled by #99799 (aside from the vformat suggestion, but that one is outside the scope of this tracker IMO, and also not a no brainer as currently vformat can be quite expensive).

Note: Please avoid starting long discussions of suggestions in this tracker, which makes it harder to use as a laundry list of things to do.

akien-mga avatar Nov 28 '24 16:11 akien-mga

Image

"Physical location" should use title case here ("Physical Location").

Calinou avatar Jul 15 '25 19:07 Calinou

Image

Node.find_children() should say "descendants" instead of "ancestors".

tomsterBG avatar Aug 22 '25 11:08 tomsterBG

https://github.com/godotengine/godot/blob/816ec99355ef404451b30eb9a87fe450a3d09a14/doc/classes/FoldableContainer.xml#L50

"becomes" -> "become" (or remove "will", I don't know what is more correct)

https://github.com/godotengine/godot/blob/9dde5688a566775df338df8ae7023cb69b6cfe6d/platform/macos/export/export_plugin.cpp#L1087

Remove ">" at the end

fstxz avatar Oct 18 '25 08:10 fstxz