Let me make a suggestion - the next person you convince to start working with clojure ... hold their hand through the process and make notes of everything you had to tell them about (because they couldn't find it in the docs) ... then at the very least publish those notes.
One of the big problems is that it's -really- hard to go back and explain this stuff once you're already an expert, and I metaphorically burts into tears at your comment because if you'd documented all the things you had to learn the hard way as you went, you'd probably've gone a noticeable way towards fixing the problem you describe.
Note: I'm not, at all, trying to criticise you for not doing so. I'm just saying that if you could arrange for this to happen as you mentor somebody else it would be really really awesome :)
Comments
Let me make a suggestion - the next person you convince to start working with clojure ... hold their hand through the process and make notes of everything you had to tell them about (because they couldn't find it in the docs) ... then at the very least publish those notes.
One of the big problems is that it's -really- hard to go back and explain this stuff once you're already an expert, and I metaphorically burts into tears at your comment because if you'd documented all the things you had to learn the hard way as you went, you'd probably've gone a noticeable way towards fixing the problem you describe.
Note: I'm not, at all, trying to criticise you for not doing so. I'm just saying that if you could arrange for this to happen as you mentor somebody else it would be really really awesome :)