Недавно довелось изучить один фреймворк. Открываю один из файлов и читаю в комментариях инструкцию для пользователей:
"CLASS USERS
Полезные советы начинающим:
класс - это набор готовых функций возвращающих какой-либо результат
ниже можно писать любые функции (только функции!)
И ТОЛЬКО ДО ЗАКРЫВАЮЩЕЙ КЛАСС СКОБКИ!
затем вызывать их в php страницах методом users-ваша функция(переменные)
не забывайте, что любая функция должна вернуть результат
используйте return в конце функций даже если значение ее равно false". Ну, что можнрукция заканчивается. Ну, что можно сказать, главное - это хорошо документированный код.

---