[CON-2811] cApiImgScale $wantHQ @deprecated
[CON-2811] cApiImgScale $wantHQ @deprecated
Seit der 4.10.0 Version ist der Parameter $wantHQ als @deprecated annotiert. Das führt im phpStorm dazu, dass die ganze Methode als deprecated angesehen wird, was lästig ist. Ich könnte in der IDE natürlich diesen Fehler ausschalten, aber dann würden echte deprecated-Methoden nicht mehr angezeigt werden. Soweit ich weiss, ist es nicht möglich einen einzigen Parameter in PHP als deprecated zu vermerken, aber vielleicht wisst ihr da mehr
Re: cApiImgScale $wantHQ @deprecated
Hallo samse,
soweit mir bekannt ist, kann man leider keine Parameter als @deprecated markieren. Fügt man das hinzu, wird die ganze Methode in der IDE als deprecated eingestuft. Entfernt man das, bekommt der User nicht mit, dass dieser Parameter nicht verwendet werden soll. Alternativ kann man das in der Beschreibung des Parameters hinterlegen, in der Hoffnung, dass die User das auch lesen, was aber auch nicht immer der Fall ist.
Wie dokumentierst du Funktionsparameter, die als deprecated eingestuft werden?
Gruß
xmurrix
soweit mir bekannt ist, kann man leider keine Parameter als @deprecated markieren. Fügt man das hinzu, wird die ganze Methode in der IDE als deprecated eingestuft. Entfernt man das, bekommt der User nicht mit, dass dieser Parameter nicht verwendet werden soll. Alternativ kann man das in der Beschreibung des Parameters hinterlegen, in der Hoffnung, dass die User das auch lesen, was aber auch nicht immer der Fall ist.
Wie dokumentierst du Funktionsparameter, die als deprecated eingestuft werden?
Gruß
xmurrix
CONTENIDO Downloads: CONTENIDO 4.10.1
CONTENIDO Links: Dokumentationsportal, FAQ, API-Dokumentation
CONTENIDO @ Github: CONTENIDO 4.10 - Mit einem Entwicklungszweig (develop-branch), das viele Verbesserungen/Optimierungen erhalten hat und auf Stabilität und Kompatibilität mit PHP 8.0 bis 8.2 getrimmt wurde.
CONTENIDO Links: Dokumentationsportal, FAQ, API-Dokumentation
CONTENIDO @ Github: CONTENIDO 4.10 - Mit einem Entwicklungszweig (develop-branch), das viele Verbesserungen/Optimierungen erhalten hat und auf Stabilität und Kompatibilität mit PHP 8.0 bis 8.2 getrimmt wurde.
Re: cApiImgScale $wantHQ @deprecated
Ich hatte in meiner Laufbahn noch nie den fall, dass eine ein einzelner Parameter deprecated wurde, sonder nur ganze Methoden.
Vielleicht ist dieser Vorschlag: https://stackoverflow.com/a/27005644/2470685 eine geeignete Lösung?
Es ist ja nichts wirklich dringendes, es wird einfach in der IDE falsch angezeigt, was zu Verwirrungen führen kann
Vielleicht ist dieser Vorschlag: https://stackoverflow.com/a/27005644/2470685 eine geeignete Lösung?
Es ist ja nichts wirklich dringendes, es wird einfach in der IDE falsch angezeigt, was zu Verwirrungen führen kann