CakePHP mistakes made

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.

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

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

Have opinions

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.

In closing,

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