ROZDZIAŁ 13.
Dokumentacja
Kto lubi pisać dokumentację, niech podniesie rękę do góry. A teraz niech się zgłoszą ci, którzy lubią wiedzieć, że interfejs API, którego zamierzają użyć, ma dobrą dokumentację z przykładami aplikacji podobnych do ich programu. Są to dwie przeciwności, ponieważ programiści z reguły nie lubią pisać dokumentacji i mimo że z reguły też jej nie czytają, dobra dokumentacja znacznie ułatwia im pracę, dzięki czemu rzadziej muszą zgłaszać błędy lub przerzucać się na produkty konkurencji.
Ktoś może utworzyć najlepszy interfejs API na świecie, a mimo to jeśli dostarczy słabą i niedokładną dokumentację lub nie dostarczy jej w ogóle, nikt nie będzie go używał. W istocie, jeśli programista nie traktuje dobrej dokumentacji jako integralnej ...