Attualmente sto lavorando a un progetto con centinaia di metodi, l'ho avviato alla cieca senza documentazione e solo ora sto iniziando a inserire la documentazione. Ho 2 lingue principali nel codice, PHP e Javascript. PHP è il mio back-end con funzioni che controllano il server e le impostazioni utente ect. Javascript fa parte del mio front-end, ma ci sono funzioni avanzate che si connettono alle API tramite ect AJAX, e ho bisogno di documentare queste funzioni.
Quindi dovrei avere una grande documentazione che ha un elenco di funzioni sia JS che PHP e mescolarle in categorie, dimenticando la differenza nella lingua o separarle completamente in diverse documentazioni?