Κάνε μια αναζήτηση για "python + docstring" και θα βρεις ολες τις πληροφορίες που χρειάζεσαι. Πρακτικά υπάρχουν οι ακόλουθοι βασικοί τρόποι που μπορείς να γράφεις τα docstrings σου:
1. Να ακολουθήσεις το PEP 257
2. Να ακολουθήσεις τις συμβάσεις της Google
3. Να ακολουθήσεις τις συμβάσεις του sphinx
4. Να ακολουθήσεις δικές σου συμβάσεις.
Αν θες η βιβλιοθήκη σου να έχει documentation σαν και
αυτό τότε θες να ψαχτείς με το sphinx, αλλά να ξέρεις ότι το markup του documentation θα είναι πιο "βαρύ" από τις άλλες επιλογές. Αν θες να διαβάζεις το documentation απευθείας από τον κώδικα, το πιο ευανάγνωστο πρότυπο είναι αυτό της google.