Follow-up for #3039568 #2711739: Missing summary/param/return docs for several QueryInterface methods → .
The direction parameter for QueryInterface::sort() needs a better description.
See why: #2711739: Missing summary/param/return docs for several QueryInterface methods →
/core/lib/Drupal/Core/Entity/Query/QueryInterface.php
/**
* Sorts the result set by a given field.
*
* @param string $field
* Name of a field.
* @param string $direction
* The direction to sort. Allowed values are "ASC" and "DESC". Any other
* value will be converted to "ASC".
* @param string|null $langcode
* Language code (optional).
*
* @return $this
* The called object.
*/
public function sort($field, $direction = 'ASC', $langcode = NULL);
?
Needs work
10.1 ✨
Not all content is available!
It's likely this issue predates Contrib.social: some issue and comment data are missing.
Given Drupal require PHP 10.1 we could use an enum to define possible directions. That would enable auto-completion in some IDEs.
The only issue is how to preserve backward compatibility.
Changing to the DX special tag defined on Issue tags -- special tags → .