This question is locked. New answers and comments are not allowed.
While I may not be the sharpest knife in the drawer, I am having problems that I suspect others may be having with regards to using your tools.
I have used your ajax tools for a number of years and really like them. Recently, I decided that I needed to learn how to develop some MVC apps and at that point learn about your ORM product which appears to be really interesting.
A couple of times, I have started with your Getting Started or quick start tutorials in the help sessions. Getting into them, I found that the help files were out of date and the screen shots that I was trying use to follow along didn't match what was happening on my screen when I was following the application.
Now I appreciate the great strides that your company seems to be making with it's tools - but have got totally frustrated trying to learn how to use them - despite your impressive library of videos and help assets.
For what it's worth, here's a couple of suggestions:
I have used your ajax tools for a number of years and really like them. Recently, I decided that I needed to learn how to develop some MVC apps and at that point learn about your ORM product which appears to be really interesting.
A couple of times, I have started with your Getting Started or quick start tutorials in the help sessions. Getting into them, I found that the help files were out of date and the screen shots that I was trying use to follow along didn't match what was happening on my screen when I was following the application.
Now I appreciate the great strides that your company seems to be making with it's tools - but have got totally frustrated trying to learn how to use them - despite your impressive library of videos and help assets.
For what it's worth, here's a couple of suggestions:
- When you have a new version of one of your tools come out, have someone go through the getting started documentation to make sure that it corresponded with the new versions of the way things are done.
- Label and date your documentation so that people know what version it is associated with. I can't tell you the number of times I have flipped between the various pieces of downloaded and online documentation trying to figure out what is happening and why what is happening on my screen doesn't correspond to the wizard/method shown on the screen.
- Provide Context! I know you guys are five star techies, and live and breath the tools and you're enthused about the multiple ways that you can use the tools. But for a plodder like myself, at least, it feels that I'm at the end of a fire hose being drenched in explanation on how to use different tools with no explanation as to why I would use them. Perhaps try something like: "The Round-Tripping approach is a method that... It is often used in situations where... It differs from the other tools in that.... Here's an example of how you would use this approach in the following situation...
Just saying... - Roger