My point is simple, documentation – including code that’s commented – matters
Consumed => “Practical Tips From Top WordPress Pros” by Siobhan McKeown on Smashing Magazine.
=> My value add (i.e., left a comment)…
Great and helpful stuff. Thanks.
While not to sound like a critic there are two points worth reconsidering:
=> “Use Everything WordPress has to offer”
Do you mean by using a Codex that is often dated and/or incomplete? With links to recommended articles that are 3+ years old? Or by finding a support question similar to your own that has no answer and has been closed? Is it any wonder so many who are new (or not) to WordPress get so disgusted so quickly? Pardon me but from what I understand the WP Codex is required reading for the detainees at Gitmo.
=> “Relying on the Codex and Google searches for solving unique problems with WordPress is like trying to tune a car’s performance without ever looking under the hood.”
With all due respect to Jake, it’s promoting myths like this that allows the Codex to be the exercise in Russian Roulette that it is. If WordPress wants to be considered a proper, respected and industry-leading framework then it should act like one. That being said, I have from time to time resorted to looking at the core. What I found was not well commented and the coding struck me as not-pretty. WordPress the product should be an object, because as we all know, everything is an object. Given the Codex, it’s more like a monkey tossing shite at the wall.
My point is simple, documentation – including code that’s commented – matters. How totally uncommented themes and plugins get into the WP repo, I’ll never know. (Actually, I do but I don’t want the Automatic police looking for my head.) Documentation, especially the Codex, is where nearly everyone ends up when they have something to resolve, often under the pressure of a deadline. My gawd, sometimes I wonder if WordPress’ docs are written by Google. That comparison alone should hit home with most of you.
Perhaps this sounds ungrateful, but it’s time we considered the idea: We deserve better.