W dokumentacji biblioteki przy jednej z metod znajduje się zdanie: „This method is deprecated and will be removed in the next major release.” Co należy zrobić w nowym kodzie?
Dlaczego tak
Słowo „deprecated” oznacza, że element jest przestarzały i niezalecany – nadal działa, ale autorzy zapowiadają jego usunięcie („will be removed in the next major release”). W nowym kodzie należy więc użyć zalecanego zamiennika, który dokumentacja zwykle podaje obok. Metoda nieukończona byłaby opisana jako „experimental” lub „preview”, a prywatna jako „private” lub „internal”.