Teraz coś ode mnie. Jak dla mnie w javadocach zawsze podobało mi się to, że ktoś za mnie robił całą czarną robotę związaną z dokumentacją. Spędza się chwilę na nauce poprawnej obsługi tego narzędzia, po czym nie trzeba pisać oddzielnych plików readme i innych tego typu głupot. Wprowadza sporo porządku. Lubię tego typu standardy, bo są w miarę jednolite - co z tego, że ktoś inny wymyśli równie dobry standard dokumentowania kodu, jeśli ja będę musiał stracić na jego naukę kolejne dwie godziny. Największy problem miałem ze współpracą tego z ide. Często można się pogubić w folderach z dokumentacją itd. Pamiętam, że na początku zajęło mi sporo czasu dogranie tego z ide i częściowo pracowałem zupełnie bez sensu z dokumentacją braną z neta. Jeśli chodzi o naszą prezentację, to proponuję następujący podział:
Paweł - integracja javadoca z Netbeansem
Sławek - to samo z Ecclipse
Przy tych integracjach oczekuję rzeczy w stylu: automatyczne dostawianie komentarzy na podstawie wklepanego kodu klasy/metody, narzędzia do obsługi javadoców, jeżeli coś takiego jest, to też podglądanie dokumentacji w trakcie pisania kodu no i generalnie wszystkie featursy będące wsparciem ide dla javadoców)
Karol - jak to się robi spod konsoli + zmiana standardowego wyglądu javadoca css'em (tu chodzi mi o krótki i chwytliwy przykład - jakiś prosty, ładny szablon; najlepiej, żeby to się dało podmienić za pomocą kilku kliknięć myszą i/lub wpisaniu ścieżki do css'a)
Ja zajmę się maven javadoc pluginem i stylem pisania tagów
Jako, że ostatnio ja nic nie referowałem, to tą prezentację poprowadzę w całości. Wasze zadanie ma charakter praktyczny, więc proszę o konkretne zastosowania, najlepiej z podanym przykładowym kodem, na którym można to będzie później pokazać reszcie grupy. Nie chcę dublować Waszej pracy, więc wytyczne mają być w deseń: "Tu klikamy na plik/zapisz... itd", tak żeby przeciętny orangutan zrozumiał. Pomyślę nad opracowaniem tego w jednym z narzędzi, o których pisał scravek. Może to wyznaczy jakiś nowy trend na zajęciach
Tymczasem pozdrawiam,
P.
Paweł - integracja javadoca z Netbeansem
Sławek - to samo z Ecclipse
Przy tych integracjach oczekuję rzeczy w stylu: automatyczne dostawianie komentarzy na podstawie wklepanego kodu klasy/metody, narzędzia do obsługi javadoców, jeżeli coś takiego jest, to też podglądanie dokumentacji w trakcie pisania kodu no i generalnie wszystkie featursy będące wsparciem ide dla javadoców)
Karol - jak to się robi spod konsoli + zmiana standardowego wyglądu javadoca css'em (tu chodzi mi o krótki i chwytliwy przykład - jakiś prosty, ładny szablon; najlepiej, żeby to się dało podmienić za pomocą kilku kliknięć myszą i/lub wpisaniu ścieżki do css'a)
Ja zajmę się maven javadoc pluginem i stylem pisania tagów
Jako, że ostatnio ja nic nie referowałem, to tą prezentację poprowadzę w całości. Wasze zadanie ma charakter praktyczny, więc proszę o konkretne zastosowania, najlepiej z podanym przykładowym kodem, na którym można to będzie później pokazać reszcie grupy. Nie chcę dublować Waszej pracy, więc wytyczne mają być w deseń: "Tu klikamy na plik/zapisz... itd", tak żeby przeciętny orangutan zrozumiał. Pomyślę nad opracowaniem tego w jednym z narzędzi, o których pisał scravek. Może to wyznaczy jakiś nowy trend na zajęciach
Tymczasem pozdrawiam,
P.