Chief Alchemist - Business Consulting For The 21st Century Via A Holistic & Intelligent Approach
Share RSS 2.0 feed for Sign up for the mailing list. Follow Chief Alchemist on Twitter. 'Like' the Chief Alchemist's page on Facebook. See what Chief Alchemist has been Q&A'ing on Quora. Chief Alchemist bookmarks & highlights on Follow the Chief Alchemist on Chief Alchemist channel on Chief Alchemist on Flickr. Mark 'Chief Alchemist' Simchock on LinkedIn. Free Initial Consultation. Email Chief Alchemist. Phone Chief Alchemist.
  • Mark ‘Chief Alchemist’ Simchock
  • 'Email me.Email => ca .at. ChiefAlchemist .dot. com
  • 'Phone me.Alchemy United => 732 997-0028
  • Free initial consultation.Free => Initial Consultation
  • Please be sure to subscribe to your communication channels of choice.
  • Click To Close => The small green (consultation), red (email) or blue (phone) icons in the top upper right.
Business Consulting For The 21st Century Via A Holistic & Intelligent Approach

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.

Will not be published. Required.
Please include http://