Docs for Walker classes

[ramiy]

See the attached patch.

[DrewAPicture]

On Walker_CategoryDropdown, I'll make these changes on commit, but note that tag order is important. @since is pretty much always first except in specific cases such as @internal tags, some @link tags and @static tags. Also, the only elements in a file that get @package and @subpackage tags are the file headers themselves.

[DrewAPicture]

In 37045:

Docs: Improve inline documentation in property and method DocBlocks for Walker_CategoryDropdown.

Props ramiy for the initial patch.
See #36300.

[DrewAPicture]

In 37046:

Docs: Improve inline documentation for property and methods in Walker_Category.

Props raimy for the initial patch.
See #36300.

[DrewAPicture]

In 37047:

Docs: Mark optional parameters in Walker_Category methods as such.

Also cleans up some syntax.

See #36300.

[DrewAPicture]

In 37048:

Docs: Improve inline documentation for properties and methods in Walker_Comment.

Props raimy for the initial patch.
See #36300.

[DrewAPicture]

In 37049:

Docs: Standardize the class DocBlock summary for Walker_Comment.

See #36300.

[DrewAPicture]

In 37050:

Docs: Improve inline documentation syntax for Walker_Comment.

• Marks optional parameters as such
• Improves existing parameter descriptions for clarity
• Syntax improvements

See #36300.

[DrewAPicture]

In 37051:

Docs: Comment display element object types for Walker_Comment are WP_Comment since 4.4.0.

See #36300.

[DrewAPicture]

In 37052:

Docs: Normalize Walker_Comment method parameter docs spacing following [37051].

See #36300.

[DrewAPicture]

In 37053:

Docs: Improve inline documentation for properties and methods in Walker_PageDropdown.

Props raimy for the initial patch.
See #36300.

[DrewAPicture]

In 37054:

Docs: The page object type in use in Walker_PageDropdown is WP_Post.

See #36300.

[DrewAPicture]

In 37055:

Docs: Improve inline documentation for properties and methods in Walker_Page.

Props raimy.
See #36300.

[DrewAPicture]

In 37056:

Docs: The page object type in use in Walker_Page is WP_Post.

See #36300.

[DrewAPicture]

In 37057:

Docs: Mark optional method parameters as such in Walker_Page.

Also normalizes parameter spacing following [37056].

Fixes #36300.

[ramiy]

Replying to DrewAPicture:

On Walker_CategoryDropdown, I'll make these changes on commit, but note that tag order is important. @since is pretty much always first except in specific cases such as @internal tags, some @link tags and @static tags. Also, the only elements in a file that get @package and @subpackage tags are the file headers themselves.

Ok, thanks for the feedback. I will remember for me next patches.

[ramiy]

@DrewAPicture you spelled my name wrong - "Props ramiy" not "Props raimy"

[DrewAPicture]

Replying to ramiy:

@DrewAPicture you spelled my name wrong - "Props ramiy" not "Props raimy"

Sorry, won't happen again.