Czy istnieje dobry termin, który jest podobny, ale różni się od „przestarzałe”, co oznacza, że metoda lub interfejs API znajduje się w bazie kodu, ale nie należy go stosować, ponieważ jego implementacja nie jest kompletna lub prawdopodobnie ulegnie zmianie? (Tak, wiem, te metody nie powinny być publiczne, yada yada yada. Nie stworzyłem swojej sytuacji, po prostu staram się jak najlepiej wykorzystać.)
Co ludzie sugerują? Eksperymentalny, Nieukończony, coś jeszcze?
Jeśli tworzę dokumentację javadoc dla tego API, która wciąż się zmienia, czy powinienem używać tagu @deprecated, czy jest lepsza konwencja? Dla mnie @deprecated oznacza, że ten interfejs API jest stary i dostępny jest nowszy preferowany mechanizm. W mojej sytuacji nie ma alternatywy, ale niektóre metody interfejsu API nie są gotowe i dlatego nie należy ich używać. W tym momencie nie mogę uczynić ich prywatnymi, ale chciałbym umieścić wyraźne ostrzeżenia w dokumentacji.