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

Don't add comments about API docs previews to PRs #3791

Merged
merged 1 commit into from
Mar 7, 2024

Conversation

michalinacienciala
Copy link
Contributor

@michalinacienciala michalinacienciala commented Mar 7, 2024

Previously we've been adding comments to PRs modifying Solidity contracts about available previews of the API documentation. As each push to the PR branch results in one such comment, PRs with a lot of pushes get quite busy with a lot of the similar comments. In the future it would be good to modify our commenting mechanism so that it would just leave one comment per PR and update it on each push. Until we do that we're turning off the PR commenting, to increase readability.

Ref:
keep-network/tbtc-v2#793
threshold-network/solidity-contracts#165

@michalinacienciala michalinacienciala added the 📖 documentation People need to know things! label Mar 7, 2024
@michalinacienciala michalinacienciala self-assigned this Mar 7, 2024
@michalinacienciala michalinacienciala changed the title Don't add comments about API docs prewievs to PRs Don't add comments about API docs previews to PRs Mar 7, 2024
Previously we've been adding comments to PRs modifying Solidity contracts about
available previews of the API documentation. As each push to the PR branch
results in one such comment, PRs with a lot of pushes get quite busy with a lot
of the similar comments. In the future it would be good to modify our
commenting mechanism so that it would just leave one comment per PR and update
it on each push. Until we do that we're turning off the PR commenting, to
increase readability.
Copy link
Member

@lukasz-zimnoch lukasz-zimnoch left a comment

Choose a reason for hiding this comment

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

Thank you for this change!

@lukasz-zimnoch lukasz-zimnoch merged commit 65a105d into main Mar 7, 2024
29 checks passed
@lukasz-zimnoch lukasz-zimnoch deleted the disable-docs-pr-comments branch March 7, 2024 10:33
lukasz-zimnoch added a commit to keep-network/tbtc-v2 that referenced this pull request Mar 7, 2024
Previously we've been adding comments to PRs modifying Solidity
contracts about available previews of the API documentation. As each
push to the PR branch results in one such comment, PRs with a lot of
pushes get quite busy with a lot of the similar comments. In the future
it would be good to modify our commenting mechanism so that it would
just leave one comment per PR and update it on each push. Until we do
that we're turning off the PR commenting, to increase readability.

Ref:
keep-network/keep-core#3791
threshold-network/solidity-contracts#165
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
📖 documentation People need to know things!
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants