CakePHPThe Yum and the Yuck
MistakesI’ve made a few.
SuccessI’ve had a bit of that too.
DisclaimerThis is not intended to be mean.
Be respectfulEveryone starts as a newbie.
No test, no bugHigh entry barriers are not healthy
Set a good examplePeople will follow.
ConflictsEgo, language & culture.
Empower othersTrust people who have proven themselves.
Be transparent“Open” is an important part of open source.
Maintenance hellMake docs dead easy to maintain
Sphinx + ElasticSearch
Winning combination
Use simple toolsMake docs accessible, & easy to contribute to.
Deployment
Push to github make
jenkins ssh
Search & offline docs
Releases & Upgrading
Releasing must be simple
26 releases this year so far.
Version numbers matter.
Semantic versioning is important. http://semver.org
Security fixesBe transparent and respond quickly.
Breaking compatibility
Mistakes should be fixed.
Migration guidesDocument what changes/breaks.
Upgrade toolsCLI sugar
Building a Framework
People will hate you.
People will love you.
Code generationPowerful, but relies on coupling.
Intelligent defaultsMake good ideas the standard
Derp defaultsWhen ideas age poorly.
ConventionsAnd configuration.
ConventionsCan lead to magic.
Magic can be evilWe meant to help, really.
Don’t GuessComputers are stupid.
Future proof APIsOption parameters make growing easy.
“Declarative” interfaces
Kind of suck in PHP
Say no to featuresSave your sanity.
Make mistakesFalling down is an effective way to learn.
Try this at homeOpen source is hard, but rewarding
Thank youhttps://joind.in/12707
!Github - markstory
Twitter - mark_story