Wpis z mikrobloga

Kod może się sam dokumentować?


@Quzin: tylko banalny kod może się sam dokumentować. Zobacz sobie bibliotekę standardową dowolnego popularnego języka, ile tam jest szczegółów odnośnie sposobu użycia, działania, wydajności, założeń jakie przyjęli projektanci, itp.
Nie da się tego wszystkiego wepchnąć w nazwy klas/metod/parametrów, a czasem nie da się tego w sensownym czasie wydedukować z implementacji
  • Odpowiedz
via Wykop Mobilny (Android)
  • 2
@wodzik: kod I testy to dokumentacja, no i jeszcze jakiś swagger, jak potrzebne jest coś więcej to oznacza to zwykle #!$%@? kod
  • Odpowiedz
@gardziok: a piszesz biblioteki standardowe, kod do DX czy jednak appki produktowe dla klienta? Weź się ogarnij chłopie bo pojęcia o branży nie masz
  • Odpowiedz
@Quzin: no jak ty piszesz tylko kod o poziomie skomplikowania "hello world" to się nie dziwię, że nie widzisz potrzeby dokumentowania
Biblioteki standardowe podałem tylko jako przykład gdzie można zobaczyć jak wygląda dobra dokumentacja. Nie ważne jaki kod czy jaka apka, zawsze się znajdzie chociaż część która wymaga dokumentacji bo samymi nazwami nie przekażesz wszystkiego co trzeba
  • Odpowiedz