The document discusses lessons learned from the creator's experience leading the development of the CakePHP framework. It touches on topics like maintaining an open and respectful community, prioritizing documentation and easy upgrades, balancing conventions with flexibility, and embracing mistakes as opportunities for growth. The overall message is that building an open source framework comes with many challenges but can be rewarding.

1. CakePHP
The yum & the yuck.
Friday, 4 October, 13

2. Me
• Developer @ FreshBooks.
• Lead Developer of CakePHP.
• markstory on Github.
• mark_story on Twitter.
Friday, 4 October, 13

3. Friday, 4 October, 13

4. Mistakes
I’ve made a few.
Friday, 4 October, 13

5. Success
I’ve had a bit of that too.
Friday, 4 October, 13

6. Disclaimer
This is not intended to be mean.
Friday, 4 October, 13

7. Community
Friday, 4 October, 13

8. Be respectful
Every starts as a newbie.
Friday, 4 October, 13

9. No test, no bug
High entry barriers are not healthy
Friday, 4 October, 13

10. Set a good example
People will follow.
Friday, 4 October, 13

11. Conflicts
Ego, language & culture.
Friday, 4 October, 13

12. Be transparent
“Open” is an important part of open source.
Friday, 4 October, 13

13. Empower others
Trust people who have proven themselves.
Friday, 4 October, 13

14. Documentation
Friday, 4 October, 13

15. Maintenance hell
Make docs dead easy to maintain
Friday, 4 October, 13

16. 3rd Round
Sphinx + Elasticsearch
Friday, 4 October, 13

17. Simple tools
Make docs accessible, & easy to contribute to.
Friday, 4 October, 13

18. Deployment
Push to
github makejenkins ssh
Friday, 4 October, 13

19. Search & offline
docs
Friday, 4 October, 13

20. Releases &
Upgrading
Friday, 4 October, 13

21. Releasing must
simple
54 release since Oct 2011
Friday, 4 October, 13

22. Version numbers
matter.
Semantic versioning is important.
http://semver.org
Friday, 4 October, 13

23. Security fixes
Be transparent and respond quickly.
Friday, 4 October, 13

24. Breaking
compatibility
Mistakes should be fixed.
Friday, 4 October, 13

25. Migration guides
Friday, 4 October, 13

26. Upgrade tools
CLI sugar
Friday, 4 October, 13

27. Building a
Framework
Friday, 4 October, 13

28. Have opinions
Friday, 4 October, 13

29. People will hate
you.
Friday, 4 October, 13

30. People will love
you.
Friday, 4 October, 13

31. Code generation
Powerful, but relies on coupling.
Friday, 4 October, 13

32. Intelligent defaults
Make good ideas the standard
Friday, 4 October, 13

33. Derp defaults
When ideas age poorly.
Friday, 4 October, 13

34. Conventions
And configuration.
Friday, 4 October, 13

35. Conventions
Can lead to magic.
Friday, 4 October, 13

36. Evil magic
Was meant to help, really.
Friday, 4 October, 13

37. Don’t Guess
Computers are stupid.
Friday, 4 October, 13

38. Future proof APIs
Option parameters make growing easy.
Friday, 4 October, 13

39. “Declarative”
interfaces
Kind of suck in PHP
Friday, 4 October, 13

40. Say no to features
Save your sanity.
Friday, 4 October, 13

41. In closing,
Friday, 4 October, 13

42. Make mistakes
Falling down is how I learn.
Friday, 4 October, 13

43. Try this at home
Open source is hard, but rewarding
Friday, 4 October, 13

44. Thank you
Friday, 4 October, 13