Warum wird von der Verwendung von @uses-Tags in Docblocks abgeraten?

Siehe Inline-Dokumentationsstandards

Hinweis: Dieses Tag wurde in der Vergangenheit verwendet, sollte aber nicht mehr verwendet werden.

Was gibt?

Ich baue ein Plugin, um einen Codex aus der Quelle eines Plugins / Theme zu @uses und ich denke, das @uses Tag wäre perfekt, um functionen mit Hooks und Hooks mit functionen zu verknüpfen.

Solutions Collecting From Web of "Warum wird von der Verwendung von @uses-Tags in Docblocks abgeraten?"

Ich bin mir nicht 100% ig sicher, aber ich denke, es liegt daran, dass die Verwendung von @uses mit @see abgedeckt werden @see

Von phpDocumentor-Dokumenten

@ uses ist @see sehr ähnlich, Informationen zu Format und Struktur finden Sie in der Dokumentation von @see. Das Tag @uses unterscheidet sich von @see auf zwei Arten. @see ist ein unidirektionaler Link, dh die Dokumentation, die ein @see-Tag enthält, enthält einen Link zu anderer Dokumentation. Das @uses-Tag erstellt automatisch ein virtuelles @ usedby-Tag in der anderen Dokumentation, die auf die Dokumentation verweist, die das @ uses-Tag enthält. Mit anderen Worten, es ist genau wie @see, außer dass ein Rücksprung automatisch hinzugefügt wird.

Der andere Unterschied besteht darin, dass @uses nur ein Element zum Verknüpfen und eine Beschreibung dieses Elements akzeptiert.

Wahrscheinlich haben WP-Leute entschieden, dass es nicht wert ist, 2 Tags zu haben, die so ähnlich sind, aber nur eins beibehalten.

BTW, @uses ist ein gutes Tag. Wenn Sie es unterstützen wollen, tun Sie es einfach und dokumentieren Sie dessen Unterstützung in der Dokumentation.