Skip to content

Add link to the submitters guide to improve validation errors message - #10776

Open
nvdaes wants to merge 5 commits into
nvaccess:masterfrom
nvdaes:improveValidationHelpMessage
Open

Add link to the submitters guide to improve validation errors message#10776
nvdaes wants to merge 5 commits into
nvaccess:masterfrom
nvdaes:improveValidationHelpMessage

Conversation

@nvdaes

@nvdaes nvdaes commented Aug 11, 2026

Copy link
Copy Markdown
Collaborator

Issue number

Fixes #10706

Summary of the issue

Sometimes, may be difficult to know how to fix errors when the validation of an add-on shows errors.

Approach

Added a link to the Add-on Manifest Validation section of the Submission Guide.

@nvdaes
nvdaes requested a review from a team as a code owner August 11, 2026 16:09
@nvdaes
nvdaes requested review from seanbudd and a lite review from Copilot and removed request for a team August 11, 2026 16:09

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

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 validation error output by adding a pointer to the repository’s Submission Guide so submitters can more easily resolve add-on manifest validation failures.

Changes:

  • Add a Submission Guide link to the validation error message written to the optional error output file.

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment on lines 408 to 411
"This add-on submission has validation errors. "
"Please submit a new version with the errors fixed. "
"To get help fixing the errors, read the Add-on Manifest Validation section of the [Submission Guide](https://github.com/nvaccess/addon-datastore/blob/master/docs/submitters/submissionGuide.md#add-on-manifest-validation) "
"Errors:\n- " + "\n- ".join(errors) + "\n\n",

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

did you consider this suggestion?

@nvdaes

nvdaes commented Aug 11, 2026

Copy link
Copy Markdown
Collaborator Author

@seanbudd , feel free to review this.

@seanbudd

Copy link
Copy Markdown
Member

can you also update the error message for an invalid version to specify the format?

E.g. change "Manifest value for 'version' is invalid 0.7.6beta9" to "Manifest value for 'version' is invalid 0.7.6beta9. Format must be major.minor or major.minor.patch"

@nvdaes

nvdaes commented Aug 13, 2026

Copy link
Copy Markdown
Collaborator Author

@seanbudd wrote:

can you also update the error message for an invalid version to specify the format?

Done. Feel free to review this.

@seanbudd

Copy link
Copy Markdown
Member

pre-commit.ci run

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.

Improve error messages when the name is not valid

3 participants