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

fix: Updated doc-check to generate config + format errors #1255

Merged
merged 11 commits into from
May 26, 2023

Conversation

maschad
Copy link
Contributor

@maschad maschad commented May 3, 2023

Closes #1273

Related: libp2p/js-libp2p#1505

@maschad maschad marked this pull request as ready for review May 15, 2023 21:21
Copy link
Member

@achingbrain achingbrain left a comment

Choose a reason for hiding this comment

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

A couple of nits, comments inline.

Can you add a test or two please - they don't have to be complicated, just something that ensures we don't break this feature in future.

See the dep-check tests as an example - there are known good and known bad projects in the fixtures folder, the tests run the command over the sample projects and assert that it succeeded or failed.

package.json Outdated Show resolved Hide resolved
src/config/tsconfig.aegir.json Outdated Show resolved Hide resolved
src/document-check.js Outdated Show resolved Hide resolved
@maschad maschad requested a review from achingbrain May 17, 2023 03:05
@maschad
Copy link
Contributor Author

maschad commented May 17, 2023

Strange CI failure as all these tests pass on my local env 🤔

@maschad
Copy link
Contributor Author

maschad commented May 22, 2023

It seems that the underlying library i.e. https://github.com/bbc/typescript-docs-verifier does not properly compile snippets on Windows due to path resolution methods. I raised an issue. In the interim we could consider ignoring the tests on windows since this particular tool is less likely to run on that OS.

@achingbrain
Copy link
Member

If Windows fails the doc-check, instead of skipping the the doc-check tests the command itself should end early on Windows and print a message - for example see how coverage is skipped at the moment, though it'd be better if it printed the relevant GH issue too, #1195 in this case.

Otherwise we could ship this, then someone who happens to do their dev on windows will find aegir doc-check fails for hard to debug reasons.

@maschad maschad force-pushed the feat/add-ts-config-docs-verifier branch from 429165b to e15497e Compare May 23, 2023 17:36
@achingbrain achingbrain changed the title docs: Updated doc-check to generate config + format errors fix: Updated doc-check to generate config + format errors May 26, 2023
@achingbrain achingbrain merged commit c97f9bf into ipfs:master May 26, 2023
github-actions bot pushed a commit that referenced this pull request May 26, 2023
## [39.0.9](v39.0.8...v39.0.9) (2023-05-26)

### Bug Fixes

* Updated doc-check to generate config + format errors ([#1255](#1255)) ([c97f9bf](c97f9bf))
@github-actions
Copy link

🎉 This PR is included in version 39.0.9 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Generate tsconfig for doc-check
2 participants