Added PHPDoc for cmd_starts_with() method by PARTHVATALIYA · Pull Request #6034 · wp-cli/wp-cli

@PARTHVATALIYA

Fix: #6033

Add PHPDoc for cmd_starts_with() method in Runner class to improve code readability, align with WordPress coding standards, and help developers understand the purpose and behaviour of the function.

@PARTHVATALIYA

@swissspidy

I believe we have a ton of missing docblocks in a lot of other places—would you like to help improve them more holistically? :)

@PARTHVATALIYA

Thank you for pointing that out! I'd be happy to help improve the docblocks more holistically. Let me know if there's a specific area you'd like me to focus on. 😊

@swissspidy

Pretty much everything in the php folder, to be honest :)

@PARTHVATALIYA

Actually, many methods are missing docblocks, and I’m not entirely sure about the purpose of each method. How can I write a proper docblock for the methods in the PHP folder without fully understanding the functionality of each one?

mrsdizzie

@PARTHVATALIYA

@swissspidy

Fair enough :) let‘s start with this one then

mrsdizzie

Choose a reason for hiding this comment

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

Sorry I don't meant to be so Nitpicky on a small PR but this is a particular case where cmd / command happens to refer to the WP-CLI binary, while in most other contexts it actually refers to a specific wp cli command (user, core, db, etc...) so it is better to clarify (even in the next function below "command" starts to refer to specific wp-cli commands again

@PARTHVATALIYA

mrsdizzie

@mrsdizzie