Support for Drupal 7 is ending on 5 January 2025—it’s time to migrate to Drupal 10! Learn about the many benefits of Drupal 10 and find migration tools in our resource center.
This is a sub-issue of #1800046: [META] Add missing type hinting to core docblocks, fix Drupal.Commenting.FunctionComment.Missing* focused on correctly adding @param and @return type hinting to the Syslog module.
Documentation patches that include type hinting are time consuming to both review and commit because one must dig into the actual code to confirm that the type hints are both correct and complete. Hence, please be patient and try to limit type hint patches to covering only a limited number of docblocks (20-25 as a guess).
Related sprint issues:
Comment | File | Size | Author |
---|---|---|---|
#3 | 1816858-03.patch | 495 bytes | bleen |
#1 | 1816858.patch | 384 bytes | bleen |
Comments
Comment #1
bleen CreditAttribution: bleen commentedIt doesn't appear that there are any docblocks in the syslog module that need work. The attached patch fixes the smallest whitespace issue in the world.
Comment #2
Lars Toomre CreditAttribution: Lars Toomre commented@bleen18 Thanks for this really small patch.
Looking at the code with the patch applied, I noticed that there is no explanation for the return statement in that same docblock. Could you add that here? I would be happy to RTBC after that is done.
The only other problem I saw with this module was an in-line comment in testSettings() at the end of the line. I do not think we should correct that problem here since this is a documentation patch. It does seem silly, though too, to create another small patch just to change the positioning of an inline comment to conform with our coding standards.
Comment #3
bleen CreditAttribution: bleen commentedComment #4
Lars Toomre CreditAttribution: Lars Toomre commentedThanks @bleen18. This small little patch is RTBC!
After this is committed, there is nothing more that needs to be done for the Syslog module in D8.
Comment #5
Lars Toomre CreditAttribution: Lars Toomre commentedWhoops... just to make sure @jhodgdon sees this, I am changing to documentation component.
Comment #6
webchickTum te tum...
Comment #7
jhodgdonThanks! Committed to 8.x and 7.x.
Comment #8
jhodgdonComment #10
Mile23