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

chore: add eslint-plugin-jsdoc #205

Merged

Conversation

kazizi55
Copy link
Contributor

@kazizi55 kazizi55 commented Oct 8, 2023

Implements #185.

I chose not plugin:jsdoc/recommended-typescript, but plugin:jsdoc/recommended-typescript-error, so that the review time and effort can be reduced. 😄

FYI
https://github.com/gajus/eslint-plugin-jsdoc#readme:~:text=typescript%22%5D%0A%7D-,...or%20to%20report%20with%20failing%20errors%20instead%20of%20mere%20warnings%3A,-%7B%0A%20%20%22extends%22

@netlify
Copy link

netlify bot commented Oct 8, 2023

Deploy Preview for valibot canceled.

Name Link
🔨 Latest commit b9cd7a7
🔍 Latest deploy log https://app.netlify.com/sites/valibot/deploys/655982c84113c9000821023e

@kazizi55 kazizi55 marked this pull request as ready for review October 8, 2023 07:33
library/src/comparable.ts Outdated Show resolved Hide resolved
library/src/error/flatten/flatten.ts Outdated Show resolved Hide resolved
@fabian-hiller fabian-hiller self-assigned this Oct 8, 2023
@fabian-hiller fabian-hiller added the enhancement New feature or request label Oct 8, 2023
@@ -16,36 +16,27 @@ type ObjectSchemas = [
...ObjectSchema<any>[]
];

/**
Copy link
Owner

Choose a reason for hiding this comment

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

In these cases, I prefer to keep the commented overflow signatures and leave the implementation uncommented. Can we configure that?

Copy link
Owner

Choose a reason for hiding this comment

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

Could you find a solution for this?

Copy link
Contributor Author

@kazizi55 kazizi55 Oct 29, 2023

Choose a reason for hiding this comment

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

I prefer to keep the commented overflow signatures and leave the implementation uncommented.

Yes!
By configuring like this, this can be implemented 😄
For overloaded functions, we only have to write one JSDoc at the top.

And I also deleted the JSDocs of implementation part.

Copy link
Owner

Choose a reason for hiding this comment

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

Thank you! I will have a look at the changes in the evening or tomorrow.

@fabian-hiller
Copy link
Owner

Otherwise this PR looks good and is ready to be merged. Thank you!

@fabian-hiller
Copy link
Owner

Can you try to sync the repo and merge the current main branch into your feature branch? I made a few structural changes.

@fabian-hiller
Copy link
Owner

Thank you again for your work! I will check the changes and try to merge this PR on the weekend!

@fabian-hiller
Copy link
Owner

@kazizi55 thank you so much for all you did and do for Valibot! I plan to make contributors like you more visible in the long run, and am generally interested in building a team around Valibot and my other projects.

@fabian-hiller fabian-hiller merged commit 380fec0 into fabian-hiller:main Nov 19, 2023
10 checks passed
@kazizi55
Copy link
Contributor Author

kazizi55 commented Nov 19, 2023

@fabian-hiller
Thank you too 😄

I plan to make contributors like you more visible in the long run, and am generally interested in building a team around Valibot and my other projects.

Sounds great!!
Can I join the team?
And is there anything I can help about building the team? 😄

@fabian-hiller
Copy link
Owner

Can I join the team? And is there anything I can help about building the team? 😄

Yes, I would be delighted. But at the moment these are just initial ideas. Let's discuss this in more detail in January when I have more time again. 🚀

@kazizi55
Copy link
Contributor Author

@fabian-hiller
OK! 😄

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

Successfully merging this pull request may close these issues.

2 participants