Making WordPress.org

Opened 4 months ago

Last modified 3 months ago

#5895 new enhancement

Add markdown validation to the readme validator

Reported by: zodiac1978 Owned by:
Milestone: Priority: normal
Component: Plugin Directory Keywords: needs-patch

Description (last modified by SergeyBiryukov)

There is a Readme validator on wordpress.org:

But this is only checking for the readme standard:

And not for the markdown.

If a plugin is for example omitting the “closing” of the title markdown, writing = V3.9.2 - 04.07.2021 instead of = V3.9.2 - 04.07.2021 = the validator wouldn't mark this with an error or warning or note.

Although it would help to show a preview (see: #2538), maybe we could validate markdown additionally.

There are some PHP markdown parser, but I am not sure if there are validators (or if those parser can be used for validating):

If we have a plugin/library for this it could be used in Github actions or other test environments before deployment to wordpress.org. Or we could maybe add this check to the pre-commit hook, so we can reject committing wrong formatted Readmes.

Thanks to @dd32, @clorith an @ocean90 for the help on Slack about this issue.

Change History (2)

#1 @SergeyBiryukov
4 months ago

  • Description modified (diff)

#2 @coffee2code
3 months ago

  • Component changed from Developer Hub to Plugin Directory
Note: See TracTickets for help on using tickets.