Új hozzászólás Aktív témák

  • coco2

    őstag

    Ha már dokumentáció került szóba, nem vagyok róla képben, milyen standard-ek léteznek rá?

    A kihívás. Új fejlesztő kerül a céghez, és az addigi kollégák zaklatása nélkül önállóan tudnia kell teljesen beletanulnia a futó alkalmazásokba csak dokumentációból. Elvárásként a lehető legkevesebb idő kelljen hozzá. Ha ezer oldal elolvasható és megtanulható egy hónap alatt, akkor mindaz, amit az ember önkéntesen szöszölve egy egész hónapig tanulna, és leírható kevesebb, mint ezer oldalban, akkor az legyen leírva.

    Ami vélhetően kell hozzá. Top-down dokumentáció a logikai szintekről és alkalmazott absztrakciókról low-level szintig. Bottom-up dokumentáció a low-level műveletekről logikai szintig. Referencia oda-vissza az implementáció és a dokumentációja között (kódban kommentek referenciával elégséges).

    Létezik-e arra standard?

    @emvy itt vagy? A standard-ek a te kedvenc témád szokott lenni.

Új hozzászólás Aktív témák