Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Enhance battery.json : Improve consistency in descriptions and naming #76567

Open
wants to merge 1 commit into
base: master
Choose a base branch
from

Conversation

Djinn247
Copy link
Contributor

@Djinn247 Djinn247 commented Sep 20, 2024

Summary

Bugfixes "Ensure consistency in battery cell descriptions and naming"

Purpose of change

This change aims to improve consistency in the naming and descriptions of Light and Medium battery cells within the JSON file. The goal is to make the descriptions and names more intuitive and uniform.

The name and description of "ultra-light battery" makes it clear whether the one you have is rechargeable or not. Awesome.
The "light battery" description, however, does not clarify that it is non-rechargeable the same way ultra-light does. This is not an issue except when the following point comes into play.
The "medium battery" name and description does not mention whether it is rechargeable or not.

So i would normally not try to recharge it if i came across the ultra-light version first because i would wait to find the "medium battery (rechargeable)"

By aligning the descriptions for rechargeable and non-rechargeable batteries, the changes reduce confusion and make the battery types easier to understand and use.

Describe the solution

  • Light Battery Cell: Added "This one can't be recharged." to the description to align it with the ultra-light battery cells, which already specify whether they are rechargeable or not.

  • Medium Battery Cell: Updated the name by adding " (rechargeable)" to make it clear this battery is rechargeable, despite not having a non-rechargeable counterpart. This ensures consistency with the naming patterns of ultra-light and light battery cells.

  • Ultra-Light Rechargeable Battery Cell: Added a missing comma in the description to ensure consistency with the non-rechargeable version. A tiny fix.

Describe alternatives you've considered

Remove "This one can't be recharged" from all descriptions and keep the clarification only in the item names across all three battery types. This would make the rechargeable status more apparent at a glance when viewing the item name. However, the "medium" battery does not have a non-rechargeable version, and if you don't see a (rechargeable) version you might think what you have is rechargeable just like before the batteries got changed.

Testing

No tests conducted, the file change was made on the Github website.

Additional context

- Added "This one can't be recharged." to the description of the light battery cell to match the format of the ultra-light battery versions.
- Added " (rechargeable)" to the medium battery cell name for clarity, aligning with the pattern of ultra-light and light versions.
- Added a comma to the rechargeable ultra-light battery cell for consistency with the non-rechargeable version.
@github-actions github-actions bot added [JSON] Changes (can be) made in JSON Items: Battery / UPS Electric power management <Bugfix> This is a fix for a bug (or closes open issue) astyled astyled PR, label is assigned by github actions json-styled JSON lint passed, label assigned by github actions BasicBuildPassed This PR builds correctly, label assigned by github actions labels Sep 20, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
astyled astyled PR, label is assigned by github actions BasicBuildPassed This PR builds correctly, label assigned by github actions <Bugfix> This is a fix for a bug (or closes open issue) Items: Battery / UPS Electric power management [JSON] Changes (can be) made in JSON json-styled JSON lint passed, label assigned by github actions
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant