Your average user does not know what a trackback is. Yet, Wordpress must let experienced users ping trackbacks. How to include trackback information without scaring away the inexperienced users (and possibly even educating them along the way)?
The solution chosen by Wordpress is to use slightly more verbosity to describe what trackbacks are:
By contrast, Magento involves a lot more knowledge than just publishing a blog. While it’s possible to assume that Magento users earn their wages by knowing how to use it, most of the time they only manipulate the system as a side-effect of handling sales in their brick-and-mortar company, or they are new to sales altogether. So, the result is a complex product with outright terse field descriptions that have very complex effects:
Who, among normal Magento users, knows what a meta keyword or meta description is? Or whether meta keywords are as useful now as they were in the good old days? But that’s not very important, since you could just ignore those fields.
What’s an URL key? Now, even an experienced web developer might have trouble with this one (it’s the equivalent of a Wordpress slug, except Wordpress displays that “URL key” field as a more easily understood “Permalink: http://www.nicollet.net/2009/05/inline-help/” with the last URL segment editable).
What about the Page Title? What’s the difference between the category name and the page title? Which is displayed where?
Things get even more complex with other areas of Magento. For instance, in a lot of places a given field is disabled and a “Use Config Defaults” checkbox next to it is checked. The problem is that there is no indication about where those configuration defaults can be changed.
Last but not least, there are several classic questions to be asked, such as “Why does this product appear as out-of-stock?” or “Why doesn’t this product appear in this category?” or “How do I set a table rate?” which require careful analysis of the dozen options that might affect the actual state of the item (enabled? present in website? present in category? stock greater that zero? set as in-stock? children items enabled, present in website and set as in-stock? …)
Inline help items
Modern Javascript libraries allow altering an existing page in a non-intrusive manner by decorating the page elements once they are loaded (or when the user asks for help). This means it’s possible to add novice-specific inline help as:
- Short text snippets under complex or technical items to explain what they are, possibly with a link to the complete explanation.
- Explanatory tooltips on hovering.
- See-also links (where do I change this configuration default? where do I set table rates?) placed exactly where the user might be wondering something.
- Move-along tutorials that detect whether data was entered in certain fields and guide the user to create items, add them to categories, and so on…
- Troubleshooting checklists (with links) to determine why a product does not appear, or why it appears out of stock.
In fact, it would even be possible for IT companies to provide their customers with customized help messages that match their specific internal processes.

Recent Comments