Lucrez la un site Drupal complex cu o mulțime de module personalizate, entități personalizate, clase personalizate, vizualizări personalizate, evenimente personalizate, abonați de evenimente personalizate, formulare personalizate, controlere personalizate. Pe scurt, o mulțime de cod personalizat.
Este o mare provocare să încercăm să păstrăm actualizată documentația tehnică a sistemului atunci când continuăm să facem modificări în aplicație în mod continuu.
Există vreo modalitate de a genera automat documentația tehnică pentru site? De exemplu.
Un modul este folosit pentru x, y, z
Vizualizarea V este folosită pentru astfel de lucruri, blocurile de vizualizare sunt folosite în astfel de pagini.
Tipul de conținut C este utilizat pentru l, m, n și este utilizat în vizualizările V1, V2, V3.
Dacă nu este complet automat, cel puțin parțial și aveți un mecanism pentru a adăuga manual articolele rămase?
Editați | ×: Mulțumesc pentru sfatul despre modulul API @cilefen. Aceasta pare a fi o modalitate bună de a genera documentație despre codul personalizat. Cu toate acestea, există și piese care fac parte din configurație - cum ar fi vizualizări, machete, blocuri etc. Care nu ar fi documentate cu modulul API.
