Dive Into Python

def buildConnectionString(params):
    """Build a connection string from a dictionary of parameters.

    Returns string."""

	Le triple virgolette sono anche un semplice modo per definire una stringa con singole e doppie virgolette, come il qq/.../ del Perl.

Ogni cosa in mezzo alle triple virgolette rappresenta la docstring, della funzione, essa documenta ciò che la funzione è in grado di fare. Una docstring, se esiste, deve essere la prima cosa definita in una funzione (i.e. la prima cosa dopo i due punti). Non è necessario dotare la vostra funzione di una docstring, ma è buona cosa farlo sempre. So che avrete sentito questa frase in ogni lezione di programmazione che avete sentito, ma Python vi dà un incentivo: la docstring rimane disponibile durante l'esecuzione del programma come attributo della funzione.

	Molti IDE di Python usano la docstring per rendere disponibile una documentazione context-sensitive, così quando scrivete il nome di una funzione, la sua docstring appare come tooltip. Questo può essere incredibilmente utile, ma la sua qualità si basa unicamente sulla docstring che avete scritto.