Hopefully that's where good docs come in ;) But I definitely agree that can cause confusion if not explained carefully.
Re:The Micro PHP Manifesto's Missing Tenet
by ericingram on Thursday January 12, 2012 @08:04PM
(#3458704)
Have you thought about releasing the framework separately? I'd be interested in working with you.
It's definitely a possibility! That would mostly just be a matter of removing the default apps and layouts, then cleaning up the configs that pertain to the CMS. Would make a fun weekend project :)
Releasing the framework separately would take care not to add confusion to the documentation side of things. Then again, having a separate 'elefant-core' project that the CMS builds on may even help...
My one bit of criticism might be, in a plain php file without any code block wrapping handler logic, it's harder to understand context. I don't know exactly where this file is getting executed, and so it's not clear where the contextual properties are coming from? Perhaps that's the point.