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

docs: improve third-party reporter docs #5285

Conversation

mark-wiemer
Copy link
Contributor

@mark-wiemer mark-wiemer commented Jan 3, 2025

PR Checklist

Overview

  • Document the Runner.constants value used by reporters
  • Mention the "missing" documentation in Runnable class
    • Runnable.prototype.xyz calls are not published to the API doc site, leading to confusion about which properties are included in a Runnable object, like a Test or a Hook.

@mark-wiemer mark-wiemer changed the title Mark wiemer/3104 third party reporters docs Fix: Improve third-party reporter docs Jan 3, 2025
@mark-wiemer mark-wiemer changed the title Fix: Improve third-party reporter docs fix: Improve third-party reporter docs Jan 3, 2025
@mark-wiemer
Copy link
Contributor Author

@JoshuaKGoldberg this is ready for review, please let me know what I'm doing wrong with these darn compliance checks, I've read the verbose logs and I'm still confused!

lib/runnable.js Outdated Show resolved Hide resolved
@JoshuaKGoldberg
Copy link
Member

From https://github.com/mochajs/mocha/actions/runs/12599907071/job/35117787163?pr=5285:

Warning: PR Body did not match required format

Heh. Not exactly informative. I think this would be fixed by mtfoley/pr-compliance-action#368 -> mtfoley/pr-compliance-action#374.

Anyway, it's that this doesn't "fix" an existing issue - just "works on". I edited the body now that the other PR is resolved. ✅

Copy link
Member

@JoshuaKGoldberg JoshuaKGoldberg left a comment

Choose a reason for hiding this comment

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

LGTM! Just a couple of question/touchup points?

lib/runnable.js Outdated Show resolved Hide resolved
@JoshuaKGoldberg JoshuaKGoldberg added the status: waiting for author waiting on response from OP - more information needed label Jan 3, 2025
@JoshuaKGoldberg JoshuaKGoldberg changed the title fix: Improve third-party reporter docs docs: improve third-party reporter docs Jan 6, 2025
Copy link
Member

@JoshuaKGoldberg JoshuaKGoldberg left a comment

Choose a reason for hiding this comment

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

Lovely, thanks :)

@JoshuaKGoldberg JoshuaKGoldberg merged commit c5a0ef5 into mochajs:main Jan 6, 2025
76 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
status: waiting for author waiting on response from OP - more information needed
Projects
None yet
Development

Successfully merging this pull request may close these issues.

📝 Docs: No documentation on third party reporters example
2 participants