CakePHP mistakes made 2015

CakePHPMistakes Made

MistakesI’ve made a few

SuccessI’ve had a bit of that too

Community

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

Documentation

Avoid Maintenance Hell

Make docs easy to maintain, simple to build

Sphinx + ElasticSearch

Winning combination

Use Simple ToolsMake docs accessible, & easy to contribute to

Deployment

Push to github

makejenkins ssh

Releases & Upgrading

Releasing Mustbe Simple

47 releases in 2015 so far

Version Numbers Matter

Semantic versioning is important. http://semver.org

Relaxed SemverHas burned us a few times already

Breaking Compatibility

Mistakes should be fixed

Security FixesBe transparent and respond quickly

Migration GuidesDocument what changes/breaks

Upgrade ToolsCLI sugar

Building a Framework

Have Opinions

People Will Hate You

People Will Love You

Code GenerationPowerful, but requires some coupling

Intelligent DefaultsMake good ideas the standard

Derp DefaultsWhen ideas age poorly

ConventionsOver configuration, where possible.

ConventionsSpawns dark magic

Magic can be EvilWe meant to help, really

Don’t GuessComputers are pretty dumb

Future Proof APIsOption parameters make growing easy

“Declarative” Interfaces

Mostly suck in PHP

Say no to FeaturesStay lean and focused

In Closing,

Make MistakesFailing in public is an effective way to learn

Try This at HomeOpen source is hard, but rewarding

Thank YouGithub - markstory

Twitter - mark_story