Attualmente sto sviluppando alcune procedure operative standard per la società per cui lavoro. Sto iniziando con gli esempi molto piccoli; come script. Attualmente ci sono diversi script scritti in diverse lingue. L'idea è di attenersi alle migliori pratiche di ciascuna lingua per lo sviluppo di uno strumento. Il vero problema per il business è che il modo in cui utilizzare uno script e il modo in cui viene usato lo script viene passato di bocca in bocca.
Pertanto, per ciascun repository, fornirò un SOP per:
-
Manuale dell'utente
-
Pratiche di codifica.
-
Best practice del controllo della versione.
-
Documentazione di aiuto
A partire da # 4 So che in Python è possibile sviluppare uno script con docstring di aiuto incorporato nel codice. Mi stavo chiedendo allora; qual è la differenza tra questo approccio e le pagine man effettive?
La maggior parte degli sviluppatori qui lavora su Windows.
In termini di best practice dovrebbero essere richiesti entrambi gli approcci o solo la documentazione Python --help integrata