Vă mulțumim că ați explicat în cele din urmă de ce documentația normală nu se face pentru dezvoltatori. A fi speriat și nu a făcut nici măcar dezvoltarea. Minunata ideologie.
M-am gândit că documentația ar trebui să descrie cum să folosești corect API-ul, componentele etc. Rețineți, dacă acționați pe documentația normală, atunci nimic nu poate fi rupt. Dacă dezvoltatorul a deviat de la regulile de lucru specificate cu componenta - el îi va spune TP. Și dacă a făcut totul conform documentației, atunci mă scuzați, ar trebui și ar trebui să funcționeze corect.
Din nou, dacă caracteristica este internă și nu ar trebui utilizată de dezvoltatori, nu este necesar să o documentați. Apoi, acesta poate fi modificat în versiunile ulterioare, nu răspunde la solicitările din TP, etc. Dar dacă se fac grile și se presupune că dezvoltatorii o vor folosi - să fie buni.
Încercarea de a ghici cum să lucrați cu componenta este o sursă constantă de bug-uri neașteptate. Când dintr-o dată se dovedește că componenta nu funcționează așa cum era de așteptat.
> Pentru un expert bine instruit pentru a înțelege codul - nu există probleme. El o va da seama și nu-l va rupe.
Cuvinte strălucitoare de la conducătorul departamentului de documentare. Da, într-o mică bucată de cod pentru a înțelege - aceasta nu este o problemă. Dar pentru a înțelege mii de linii de fiecare dată când utilizați o caracteristică - aceasta nu este dezvoltatorii nu au timp sau dorință. Mai ușor de scris.
Imaginați-vă dacă dezvoltatorii PHP nu au documentat nimic și au spus că "doresc să scrie scripturi - să înțeleagă codul sursă PHP". Da, i-am explicat șefului departamentului de documentare nevoia de documentare.
Vă mulțumim că ați explicat în cele din urmă de ce documentația normală nu se face pentru dezvoltatori. A fi speriat și nu a făcut nici măcar dezvoltarea. Minunata ideologie.
Eugene, există două puncte.
Primul este deficiențele departamentului nostru, în special al meu.
Al doilea este poziția oficială a companiei cu privire la anumite aspecte.
Pentru prima - mă poți "lovi" cât mai mult, dacă e vina, atunci e vina.
În cel de-al doilea caz, vă înșelați. Dezvoltatorul contului de componente este obligat să sublinieze unele dintre componente. Acesta este dreptul lui.
M-am gândit că documentația ar trebui să descrie cum să folosești corect API-ul, componentele etc.
Crezi că ai dreptate. Rămâne doar să se înțeleagă că în cazul în care documentația este scrisă oficial nu este documentată, aceasta înseamnă că, în acest caz, „dreptul de a utiliza API-ul“ - este de a lăsa așa cum a făcut dezvoltatorii.
8-800-250-1860 Contactați-ne Harta site-uluiTrimiteți-le prietenilor: