Wednesday 13 January 2016

Abandonware: "Learn CFML in 24h" notes

I've just been talking to a few people on the CFML slack channel about the sorry state of ColdFusion documentation.

A while back I started a private project "Learn CFML in 24 hours", which was gonna be my attempt at teaching people CFML in a style appropriate to 2015 (or perhaps 2014, at the time). There's other learning material out there, but I think all of it does CFML a disservice, and I wanted to move people on from that.

But I can't be arsed.

I find writing easy... most of these articles are created at about 100wpm... rattled out as fast as I can spew my stream of consciousness onto the screen via the keyboard. But I find focus and motivation very difficult. unless it's typing drivel straight from my brain, things become tricky, so I never finish anything I start. And that project is no different to any other I've started.

Seen in that light, I've just converted it from a private repo on Github to a public one.

My idea is people can look at what I've done and perhaps add some stuff or perhaps guilt-trip me into writing more, or... whatever.

The project is at I present it as-is. There is currently no licence, which means it's not licensed for anyone's use. I'll CC it or something soon.

I'm OK with continuing to write it, actually. Maybe I just need some direction from the community as to where to go in various areas. Raise issues I guess. I dunno. If anyone gets a handle on the editorial slant I am trying to take with it and wants to contribute, then I'll take pull requests. Perhaps discuss them with me first though.

BTW, Mark Drew helped me a lot with this when I first started this: with tone, motivation and general "food for thought". He might not realise how much I appreciated his input, so it's worth mentioning.