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

Rewrite MySQLnd statistic page #3357

Merged
merged 32 commits into from
May 9, 2024
Merged

Rewrite MySQLnd statistic page #3357

merged 32 commits into from
May 9, 2024

Conversation

Girgias
Copy link
Member

@Girgias Girgias commented Apr 28, 2024

  • Remove personalization
  • Improve document structure
  • DocBook 5.2 conformance

This is probably easier by comparing to the actual live page: https://www.php.net/manual/en/mysqlnd.stats.php

The only things that really ought to be looked at, are my TODO comments.

@kamil-tekiela
Copy link
Member

Thanks, I am in the process of reviewing this but there are a lot of changes here and it has raised many questions for me. I hope to get back to you with something tomorrow or the day after tomorrow.

@Girgias
Copy link
Member Author

Girgias commented Apr 30, 2024

Thanks, I am in the process of reviewing this but there are a lot of changes here and it has raised many questions for me. I hope to get back to you with something tomorrow or the day after tomorrow.

No worries, I also had many questions while rewriting this and expected this to take a while to review :)

Copy link
Member

@kamil-tekiela kamil-tekiela 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 PR. I appreciate how much work you have put into this. I like how the page looks now and I am happy with most of your changes. I have highlighted some typos and answered your TODOs. I have also left some TODOs for myself as I investigate these statistics. I'll need some time to do this and in the meantime you can fix the issues I identified.

I have a gripe with this whole feature. I would love it if we could deprecate the statistics and remove them soon. I think I lost some of my sanity while reading this page. But that is off-topic.

reference/mysqlnd/stats.xml Show resolved Hide resolved
reference/mysqlnd/stats.xml Outdated Show resolved Hide resolved
reference/mysqlnd/stats.xml Outdated Show resolved Hide resolved
reference/mysqlnd/stats.xml Outdated Show resolved Hide resolved
reference/mysqlnd/stats.xml Outdated Show resolved Hide resolved
reference/mysqlnd/stats.xml Outdated Show resolved Hide resolved
reference/mysqlnd/stats.xml Outdated Show resolved Hide resolved
reference/mysqlnd/stats.xml Outdated Show resolved Hide resolved
reference/mysqlnd/stats.xml Outdated Show resolved Hide resolved
Comment on lines +1787 to +1597
<!-- TODO: XInclude/sync description of INI setting
ini.mysqlnd.net-cmd-buffer-size with this statistic -->
Copy link
Member

Choose a reason for hiding this comment

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

Is the link not enough?

Copy link
Member Author

Choose a reason for hiding this comment

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

So, when I had a link at the INI setting description it was just a copy paste from it, so the INI setting description might need a rewrite, which is why I put that TODO comment here

@Girgias
Copy link
Member Author

Girgias commented May 1, 2024

Thank you for the review!

I tried to address each review comment in a separate commit so it's easy to figure out what changed. Still missing a couple as it seemed you needed to think about them some more. :)

@Girgias
Copy link
Member Author

Girgias commented May 3, 2024

Made the suggested changes

@Girgias
Copy link
Member Author

Girgias commented May 8, 2024

@kamil-tekiela do you have any more comments? I would like to merge this sooner than later.

Copy link
Member

@kamil-tekiela kamil-tekiela left a comment

Choose a reason for hiding this comment

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

Please address these last remarks of mine and then you can merge, I will look at the rest of it sometime in the future once I have a moment.

reference/mysqlnd/stats.xml Outdated Show resolved Hide resolved
reference/mysqlnd/stats.xml Outdated Show resolved Hide resolved
reference/mysqlnd/stats.xml Outdated Show resolved Hide resolved
@Girgias Girgias merged commit 5837fed into php:master May 9, 2024
2 checks passed
@Girgias Girgias deleted the mysqlnd-docbook branch May 9, 2024 00:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants