Over the last few weeks I've read a few forums comments that have suggested that concrete5 may have become increasingly inaccessible to designers and those that have modest CSS/HTML skills, that over time things have become more developer focused.

It got me thinking about what the current learning curve is of concrete5 and what learning needs to take place to 'jump in' to developing something more custom like a theme or a block - those first steps into development, rather than just editing.

Whilst the doco does cover pretty much everything, I started to consider someone who might be wanting to create a custom theme for the first time and where they'd start. I could imagine that to someone who isn't generally comfortable with PHP that the doco when seen at a high level is enormous and daunting. That's not a criticism of the doco at all, it has an enormous breath to cover and needs to strike a middle ground. Some may simply want a very gentle overview of _only_ what they need to do to be able to get to the point where than can then just write their CSS, and not all the other details (to begin with at least).

So as a bit of an alternative I thought I'd experiment with putting together an example theme, in a package, where it's _heavily_ commented. The idea being that you could read through the notes and comments to learn nearly everything you need, almost as a stand alone piece of documentation. Kind of like a 'learn by example'.

I've pushed this up to here:
https://github.com/Mesuva/anatomy_theme...

What you do is read the README.md file first, get to the end and it tells you what to look at next - then you do the same in the next file, repeating until you've covered everything.

The idea is that if you think concrete5 is great and you'd like to try creating your own them, but you're not really sure how to approach it, you can work your way through this package to learn about how its put together. You can also use the package itself as a starting point, you could just rename it and start theming directly by editing the CSS and HTML parts only.

Once people see that the code required to set up a package and theme is really quite minimal and it follows a strong pattern, they might more confident they can immediately apply their existing CSS/HTML skills, rather than writing off the possibility.

This one is focused _just_ on getting a theme installed via a package, 'Anatomy Theme Package'. I know that themes can be installed without being in a package, but since themes often have extra blocks (or block templates), it's better to outline and encourage this extra step.

If people find a lot of value in this, I'll create another package in the same way that focuses just on basic block development, 'Anatomy Block'.

I'd welcome any feedback or corrections, pull requests, whatever makes it more useful as a learning resource.

I'm not in any way trying to replace any documentation, just add to the different kinds of resources available to help people realise how kick-ass concrete5 is to build stuff with.