While I'm typing this post, I'm actually on vacation. A road trip to a destination in hopes to relax and unwind from my daily routines. However, I had to bring the laptop for informational purposes (of course). On the road, I was thinking about some of the posts that I have created and also of those that I refer back to. I also compared a lot of these posts against the increased visibility toward the S.O.L.I.D. principles of Object Oriented design. The more I thought about it, the more I became inspired on the question of should people who read blogs and go to presentations expect more from the authors?
In my opinion, the presentations and the traditional style of technical blog posts are fine. I feel like they teach a concentrated concept in a, hopefully, straight forward manner. Some topics provide more practical implementation; however, how many times have you ran across a demo where the variables were only named Foo and Bar? Presenting a concept is great and effective; however, should more be provided in the examples of in a supplemental post on how to apply the information "properly"?
I said earlier that presentations and the traditional blog post is fine as is. The reason why I say this yet question the example code is that the extra stuff (i.e. Unit Tests, Full Comments, properly design class structures) can sometimes sidetrack the post or presentation. Questions often rise about these ancillary items as opposed to the concept you are attempting to teach. So, with that said, I still believe that the posts and presentations are fine.
Should we expect more from the Example Code? In my opinion, yes. I know I have a lot of work to do since adding such polish is time consuming; however, if it can assist in improving the overall quality of the code someone else uses, then it'd be worth it.
What do you think? Should those of us that read blog posts and presentations expect more from the example code tied to such? Should those of us that author posts provide a more comprehensive look at their code in order to encourage better practices?
What do you think?