Chcesz dokumentacji? Napisz ją sam – chyba każdy z użytkowników OpenSource zetknął się z taką informacją zawartą w plikach towarzyszących właśnie uruchamianemu oprogramowaniu. Choć nie zawsze programista potrafi napisać porządną dokumentację użytkownika, to jednak warto, aby pamiętał, że ktoś może próbować ją napisać. Jednak dobrze by było, gdyby ten ktoś wcześniej miał szansę dobrze poznać kod źródłowy. Jest to utrudnione bez komentarzy, których – podobnie jak dokumentacji – w otwartym oprogramowaniu często jest za mało.
Instrukcję pisania komentarzy, a także informacje, na co szczególnie powinno się zwracać uwagę, znajdziecie w tekście dostępnym na łamach NewsForge. Może warto sobie wziąć do serca część zawartych tam uwag?
Archiwalny news dodany przez użytkownika: honey.
Kliknij tutaj by zobaczyć archiwalne komentarze.