Skip to content

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

Merged
achingbrain merged 11 commits intoipfs:masterfrom
maschad:feat/add-ts-config-docs-verifier
May 26, 2023
Merged

fix: Updated doc-check to generate config + format errors#1255
achingbrain merged 11 commits intoipfs:masterfrom
maschad:feat/add-ts-config-docs-verifier

Conversation

@maschad
Copy link
Copy Markdown
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
Copy Markdown
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.

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

maschad commented May 17, 2023

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

@maschad
Copy link
Copy Markdown
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
Copy Markdown
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
Copy Markdown

🎉 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