The document outlines key lessons learned in open source project management, particularly regarding CakePHP. It emphasizes the importance of community respect, transparency, and effective documentation tools while advocating for simplicity in deployment and versioning strategies. The author reflects on the value of making mistakes and learning from them in the open source environment.

1. CakePHP
Mistakes Made

3. Mistakes
I’ve made a few

4. Success
I’ve had a bit of that too

5. Community

6. Be Respectful
Everyone starts as a newbie

7. No Test, No Bug
High entry barriers are not healthy

8. Set a Good Example
People will follow

9. Conflicts
Ego, language & culture

10. Empower Others
Trust people who have proven themselves

11. Be Transparent
“Open” is an important part of open source

12. Documentation

13. Avoid
Maintenance Hell
Make docs easy to maintain, simple to build

14. Sphinx +
ElasticSearch
Winning combination

15. Use Simple Tools
Make docs accessible, & easy to contribute to

16. Deployment
Push to
github
makejenkins ssh

17. Releases &
Upgrading

18. Releasing Must
be Simple
47 releases in 2015 so far

19. Version Numbers
Matter
Semantic versioning is important.
http://semver.org

20. Relaxed Semver
Has burned us a few times already

21. Breaking
Compatibility
Mistakes should be fixed

22. Security Fixes
Be transparent and respond quickly

23. Migration Guides
Document what changes/breaks

24. Upgrade Tools
CLI sugar

25. Building a
Framework

26. Have Opinions

27. People Will Hate You

28. People Will Love You

29. Code Generation
Powerful, but requires some coupling

30. Intelligent Defaults
Make good ideas the standard

31. Derp Defaults
When ideas age poorly

32. Conventions
Over configuration, where possible.

33. Conventions
Spawns dark magic

34. Magic can be Evil
We meant to help, really

35. Don’t Guess
Computers are pretty dumb

36. Future Proof APIs
Option parameters make growing easy

37. “Declarative”
Interfaces
Mostly suck in PHP

38. Say no to Features
Stay lean and focused

39. In Closing,

40. Make Mistakes
Failing in public is an effective way to learn

41. Try This at Home
Open source is hard, but rewarding

42. Thank You
Github - markstory
Twitter - mark_story