Sto scrivendo una classe (con relativa documentazione) ma non so dove mettere gli esempi
Secondo voi è meglio inserire degli esempi "generali" nell'introduzione della classe (come ad esempio su php.net) e lasciare a chi la usa il divertimento di cercare più dettagli nel codice oppure scrivere degli esempi più specifici nella descrizione di ogni metodo?