Pytania oznaczone «javadocs»

18
Kod samodokumentujący vs Javadocs?

Ostatnio pracuję nad refaktoryzacją części bazy kodu, z którą obecnie mam do czynienia - nie tylko po to, aby lepiej ją zrozumieć, ale także aby ułatwić innym, którzy pracują nad kodem. Zwykle opieram się na myśleniu, że samodokumentujący się kod jest fajny . Po prostu uważam, że jest czystszy i...

11
Przestarzałe vs. zmigrowane w JavaDoc?

W JavaDoc dla X509Certificate getSubjectDN()tego stwierdza: Przeniesiony , zastąpiony przez getSubjectX500Principal (). Przyzwyczaiłem się do wycofywania metod for, które nie powinny być już używane, ale nie poddane migracji. Znalazłem raport o błędzie dotyczący tego konkretnego przypadku, w...

9
Jak aktualizować przykłady kodu w javadocs

Pracuję nad małą biblioteką, która zapewnia implementacje podstawowych, dobrze znanych metryk ciągu. Głównie dla mojej własnej edukacji. Rozwój odbywa się za każdym razem, gdy mam trochę wolnego czasu. Z tego powodu zautomatyzowałem większość procesów, dzięki czemu mogę wypuszczać wersję tak...