Napisałem ostatnio u siebie w pracy bardzo prostą aplikację w Laravel. Logowanie po ldap, formularz do wyszukiwani z bazy danych oracla klientów, kilka widoków i cache w plikach.
Aplikacja działa już kilka tygodni, jednak dyrektor wpadła na pomysł, że trzeba do tego dołączyć dokumentację. Jako programista jestem raczej amatorem i większość tego co robię nie opuszcza mojego komputera. Nie pracowałem też nigdy jako programista w żadnym korpo, czy nawet u Januszów, wiec tym bardziej nie pisałem technicznej dokumentacji projektu.
Dostałem na wzór dokumentacje innego systemu w firmie, ale tam jest wszystko autorskie i ktoś opisał, każdy plik i funkcję jaka tam się znajduję.
Jeżeli przyszło Wam pisać prostą aplikację opartą na frameworku to na ile rozpisywać się na temat działania samego frameworka, a na ile tylko własne elementy? Jeżeli oparłem autoryzację o ldap, to opisywać cały mechanizm logowania, czy tylko własne skrypty?
Podobnie z bazą danych, gdzie Laravel nie wspiera z marszu Oracla, jak również i do Apache musiałem coś doinstalować.