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

Improve config comments & ordering #6108

Open
wants to merge 15 commits into
base: 2.x
Choose a base branch
from

Conversation

JasonHorkles
Copy link
Contributor

@JasonHorkles JasonHorkles commented Mar 24, 2025

This PR significantly overhauls the comments of the EssentialsX configuration files, ensuring consistency, clarity, and overall improved grammar (validated by Grammarly and LLMs). There are still a few things that must be completed before this is ready to be merged, but no further significant changes are expected. A couple of options have been moved entirely to make more logical sense, but this will not affect any compatibility.

Remaining tasks:

  • Ensure permission consistency when surrounded by apostrophes
  • Make quotation and apostrophes consistent (values, permissions, and config references surrounded by apostrophes. Names/examples surrounded by quotes)
  • Make 'permissions plugin' be consistent (vs 'permission plugin')
  • Ensure consistent indentation
  • Lowercase mob names (if any remain)
  • Replace 'users' with 'players'
  • Ensure consistent 'above' and 'below' formatting (either make all or none of them surrounded by parentheses)
  • Pull new changes and repeat above steps
  • Separate commit: Add 'default' comment to every option (decided this is unnecessary and instead added a link to the default config)

This makes a bit more logical sense in the ordering
This adds slightly more logical ordering to the sign list, keeping them in related groups while sorting them alphabetically. Full alphabetical feels a bit messy, but could still be a valid option.
Includes permissions/files/keys surrounded by apostrophes, 'user' references replaced with 'player' (where appropriate), and additional grammatical fixes.
Almost there! Includes consistency with apostrophes and quotation marks, fixes some capitalization, and changes references of 'permission plugin' to 'permissions plugin' (naming verified by LuckPerms)
@JasonHorkles JasonHorkles marked this pull request as ready for review March 27, 2025 00:21
@JasonHorkles JasonHorkles requested a review from Copilot March 27, 2025 00:21
Copy link

@Copilot Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull Request Overview

This PR improves the configuration file comments for EssentialsX, enhancing clarity, consistency, and punctuation across several resource files.

  • Enhanced phrasing and punctuation in kit configuration.
  • Standardized comment styles in custom item, worth, and teleport configurations.
  • Updated URLs and command syntax for clarity.

Reviewed Changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated no comments.

File Description
Essentials/src/main/resources/kits.yml Improved comment phrasing and ordering
Essentials/src/main/resources/custom_items.yml Updated comment clarity on alias limitations
Essentials/src/main/resources/worth.yml Refined wording of worth configuration comments
Essentials/src/main/resources/tpr.yml Clarified command syntax in the teleport config

@JasonHorkles JasonHorkles marked this pull request as draft March 31, 2025 18:33
@JasonHorkles JasonHorkles marked this pull request as ready for review March 31, 2025 18:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant