Documentazione delle variabili in un modulo Python

3

Sto scrivendo un modulo Python che usa Numpy. Sto cercando di seguire il formato di Numpy docstring . In molte delle mie funzioni, vengono visualizzati gli stessi parametri. Sembra ripetitivo spiegare quali sono in più di una funzione dallo stesso modulo. C'è una pratica comune quando si tratta di questo?

    
posta Vermillion 08.12.2016 - 02:12
fonte

1 risposta

4

Aggiungi una descrizione dettagliata dei parametri alla documentazione della classe o del pacchetto e aggiungi un breve riferimento ad essa dalla documentazione di ogni funzione. Fondamentalmente, mordere il proiettile. Questo non può essere automatizzato o convenientemente migliorato di più.

    
risposta data 08.12.2016 - 04:14
fonte

Leggi altre domande sui tag