Recensioni e Dettagli del Prodotto phpDocumentor

- Facilità d'uso

- Generazione diretta della documentazione dal codice e visibilità dei commenti nel sorgente

- Connessione diretta alla gerarchia di classi/namespace

- Ho trovato la funzione di generazione UML piuttosto utile poiché utilizziamo strumenti di modellazione

- Configurazione relativamente semplice anche per progetti legacy e supporto immediato tramite PHAR (bello!)

- Mi piace il fatto che supporti il tuo codice generando la tua documentazione con PHPDocumentor Recensione raccolta e ospitata su G2.com.

Ho trovato un po' difficile controllare come le cose sono organizzate nel risultato finale. Ad esempio, un ordinamento personalizzato di classi/spazi dei nomi sarebbe fantastico. Recensione raccolta e ospitata su G2.com.

La funzionalità che lo strumento mi ha proposto per generare la documentazione direttamente dal codice sorgente PHP rende il mio progetto più robusto e autoriale, utilizzando lo strumento javadoc che mi permette di aggiungere commenti rilevanti e scartare documentazione ripetitiva, formando una documentazione unica in diversi formati, con un grande obiettivo per me di fornire tutti gli strumenti e le risorse necessarie per scrivere documentazione efficace e completa con il minimo sforzo possibile. Avendo un sistema di template flessibile che ti permette di cambiare il tuo output in modi diversi e con vari modelli, framework, architetture plug-in, come WordPress o PyroCms, tra gli altri. Recensione raccolta e ospitata su G2.com.

Non ci sono state cose negative durante il mio utilizzo. Il software ha funzionalità con funzioni che aggiungono molto all'organizzazione. Recensione raccolta e ospitata su G2.com.

Ho iniziato a usare phpDocumentor dal 2010. E questo strumento è molto utile per documentare la mia libreria PHP. Recensione raccolta e ospitata su G2.com.

Per me, non ci sono stati svantaggi con phpDocumentor. Ma è solo necessario avere la disciplina di eseguirlo per aggiornare la documentazione del codice. Recensione raccolta e ospitata su G2.com.

Questo è utile perché possiamo navigarli più velocemente dei file di codice e ottenere una documentazione molto bella che può essere distribuita a tutti gli sviluppatori del team, ai fornitori di servizi terzi o ai nuovi membri del tuo team senza molto lavoro aggiuntivo. Recensione raccolta e ospitata su G2.com.

È quasi obsoleto.. Non ci sono più sviluppi o miglioramenti significativi Recensione raccolta e ospitata su G2.com.

La facilità dell'interfaccia utente e il contenuto complessivo sono molto istruttivi. Recensione raccolta e ospitata su G2.com.

Oltre agli argomenti, ci dovrebbero essere più esempi. Recensione raccolta e ospitata su G2.com.

Sintassi facile

Supportato dagli IDE

Incorporato nel codice Recensione raccolta e ospitata su G2.com.

Nessun supporto per parametri con array tipizzati annidati né per array chiave-valore. Recensione raccolta e ospitata su G2.com.

Automatizzare la generazione di commenti. I commenti hanno la struttura corretta. Recensione raccolta e ospitata su G2.com.

I commenti in casi molto rari necessitano di correzione. Recensione raccolta e ospitata su G2.com.

Mi piace molto la sua funzionalità in sé, è uno strumento che ci permette di auto-documentare il codice che abbiamo scritto nel linguaggio PHP e questo viene fatto automaticamente utilizzando il codice sorgente. Mi piace molto che utilizzando uno strumento come questo per tutto il codice che programmiamo, ci permette di avere una sorta di modello di documentazione che i nostri codici hanno e di poter comprendere più facilmente ciò che è programmato e quali funzioni si trovano in ogni sezione. Mi piace molto che l'uso di questo strumento ci permetta di continuare facilmente il codice lasciato da qualche altro programmatore o che qualche collaboratore continui facilmente il codice creato da noi poiché ci permette di avere una buona documentazione. Mi piace anche molto che ci permetta di migrare l'intero codice in un file HTML con un grande grado di dettaglio di tutto, dai commenti alle funzioni, variabili, tra le altre cose. Recensione raccolta e ospitata su G2.com.

Fondamentalmente l'unico aspetto negativo è la piccola comunità che ha e che forse non è ancora uno strumento che ha ricevuto il riconoscimento che merita, ma la verità è che è uno strumento che costringe il programmatore ad avere una buona pratica di codifica. Recensione raccolta e ospitata su G2.com.

- Php Documentor ha diversi modelli per rendere la documentazione più gradevole alla vista dell'utente.

- Php Documentor è in grado di interpretare le informazioni per creare grafici e report.

- Php Documentor ha una sezione importante per riportare tutti i `TODO` che si trovano nel codice.

- Php Documentor crea l'intera wiki per tutte le funzioni; anche il costruttore e le costanti per ogni classe. Recensione raccolta e ospitata su G2.com.

- Nonostante abbia molti modelli, sembra che i modelli siano troppo vecchi per gli strumenti HTML attuali.

- L'installazione non è facile da eseguire. Recensione raccolta e ospitata su G2.com.

È il massimo poiché, come programmatore e per i tempi di esecuzione, è difficile commentare il codice, questo strumento analizza il codice sorgente e genera un file seguendo gli standard di programmazione, il che aiuta a comprendere i propri codici e quelli di altri programmatori. Recensione raccolta e ospitata su G2.com.

Non funziona, ma se segui certi parametri o standard della programmazione, può darti dei fallimenti. Recensione raccolta e ospitata su G2.com.