That’s a great question!
Why oh why have WD not provided the end user with an official Guide to the Theming Code?
And before anyone says there is a guide/ Theme Defination…
…Yes I know and it is posted here by Joey Smyth…
…this used to be available for download on the wd official site, but the link has now disappeared. I also understand that this is currently being reviewed/ editted by WD, which again shows the lack of product support by WD at the initial launch of the ‘hub’, which literally left themer’s out in the dark to find out things themselves…
I would also consider the published guide to be rather inadequate and poorly written which does not even explain the FULL code and variables currently present. Hence why Joey Smyth and others had to spend numerous hours based on a ‘trial and error approach’ to find out the such discoveries and the ‘hidden’ affects of what is suppose to be an open and free code!
And lets NOT forget Tinwarbles invaluable posts here to try and explain the ‘basics’ of the theming code and fill in the MASSIVE gaps left by the WD official guide.(Note this is only 1 of numerous posts by Tinwarble which were extremely helpful and informative back in the very early days of theming)
So will WD make a concerted effort to make Theme Design a pleasure rather than a pothole experience without a torch?