In this pair of posts, I describe the BricsCAD documentation system. Click here for part 1, where I describe the general Help system and the descriptions in the Settings command.
In this part, I discuss developer documentation and draw my conclusions.
If we count the Settings descriptions as a system, there’s a third documentation system for BricsCAD. The Developer Reference isn’t offline and included in an install like the main Help. Instead, it’s online, just like Autodesk’s default. Unlike Autodesk’s system, it works pretty well.
Being online means the performance suffers, of course, but it’s generally not too bad. It appears quicker than Autodesk’s. A link within the main Help system takes you to the Bricsys Developer Reference which is just accessed using your default browser. Of course, that means your mouse buttons work correctly and you have all other the advantages of whatever … Full post →
Because of the great similarity between BricsCAD and AutoCAD in terms of commands, variables and most aspects of usage, you would expect the BricsCAD documentation to be about the same too. But it isn’t. Much of the content covers the same areas and due to BricsCAD’s command-line compatibility, there must be a lot in common. But the Help system is very different from Autodesk’s. How so?
In this pair of posts, I describe the BricsCAD documentation system. I assume you’re familiar with the AutoCAD one. In this first part, I describe the general Help system and the descriptions in the Settings command. In part 2, I will discuss developer documentation and draw my conclusions.
The general Help system in BricsCAD looks a lot like the excellent CHM-based system that AutoCAD had in 2010 and earlier (thanks, Dieter). BricsCAD’s Help is offline by default, included with the … Full post →
This isn’t supposed to be an Autodesk-bashing blog. Really, it’s not. Sure, Autodesk (and anyone else) gets criticism where deserved. There’s been a lot of that lately, but only because Autodesk has thoroughly deserved it. I don’t make up things so I can have a go; Autodesk provides the material all by itself.
Among other things, I’m a customer advocate. I don’t care who you are, act in an anti-customer manner and I’m going to slam you. Hard but fair. Dish up bullshit to your customers and I will gleefully point that out and heap derision on you. Deal with it.
On the other hand, act in a pro-customer manner and I’m going to praise you. I do praise Autodesk (and anyone else) where deserved. There are dozens of examples of that on this blog. Lately, the pickings have been slim. Time to redress the balance a little.
The most heavily commented post on this blog is AutoCAD 2013 – An Autodesk Help writer responds, featuring Dieter Schlaepfer‘s response to posts and comments here about AutoCAD 2013’s Help. I don’t always agree with Dieter but I respect him enormously, and not just because he was brave enough to stick his head above the parapet in a hostile environment. Dieter is a principal technical writer at Autodesk with many years’ experience and is therefore responsible for large amounts of documentation content. You’ve almost certainly read his work.
I’ve been critical of AutoCAD’s Help system since it was broken in 2011, and I make no apologies for that. The Help system sucked then, it sucked even worse in 2013, and it continues to suck badly in 2017. None of that’s Dieter’s fault. It’s the Help engine that’s at fault, or to be more accurate the Help … Full post →
In a recent post on Between the Lines, Shaan passed on the following response from the AutoCAD Team:
There has been some recent discussions about the built-in help system in AutoCAD 2013, both positive and some criticism. As our longtime users know, AutoCAD help has been through many evolutions.
We are particularly proud of the new AutoCAD 2013 online learning environment we recently released (AutoCAD Online Help Mid-Year Updates.) This update addressed several user requested fixes and changes, and we will continue to take our direction from our user’s feedback.
We do recognize that the online learning environment may not be the solution for every user, so while we are focused on creating a rich and personalized online experience, we will continue to maintain our current basic offline experience.
(The emphasis is mine). This statement, although couched in marketingspeak, confirms what I’ve had to say on the subject. … Full post →
Following my comments on The Hitchhiker’s Guide to AutoCAD, Autodesk’s Dieter Schlapfer has sought to explain the reasoning behind it. Here’s what he has to say:
As mentioned previously, The Hitchhiker’s Guide to AutoCAD is designed for occasional AutoCAD users and those coming back from their initial training. These are people who just need a base level of knowledge in 2D AutoCAD to get things done, and who don’t necessarily want to become experts. To make future versions more effective, I really want to get some input on the 42 AutoCAD commands, and any descriptions or illustrations that are not clear. Especially valuable to me is feedback coming from occasional users.
Here’s some history. Believe it or not, the 42 commands came first! I kept flaunting this number, which was based on an internal AutoCAD overview class that I taught a while back, in response to people who complained … Full post →
Some months ago, I gave Autodesk severaldamngood (and thoroughly well-deserved) thrashings over its hopelessly inadequate AutoCAD 2013 Help system. When Autodesk’s Dieter Schlaepfer responded and asked for feedback, he sure got it. There are 142 comments on that one post to date, most of them leaving nobody under any illusions about how short of the mark the new system was.
There is now an updated version of the AutoCAD 2013 Help system. It has been an interminably long time coming, a fact made far worse by Autodesk’s stubborn refusal to provide a CHM stopgap (which could have easily been done on the ship date with minimal resources if the will had been there), but at least an update is here now. Is it any good, though?
I’ve seen fit to give the online version of the … Full post →
I’ve added a poll asking this question over on the right. I would like to see this done as soon as possible as a courtesy for those customers who find the current AutoCAD 2013 Help system inadequate. If you agree, vote Yes. If you disagree (for example, you think Autodesk should instead concentrate on improving the current system), vote No. If you wish to make a comment on this specific issue, feel free.
Following some email discussions, I am happy to present a response from a relevant Autodesk person to the posts and comments here about AutoCAD 2013’s Help.
Thanks for the opportunity to respond to your readers, Steve.
First, I want to assure you that we’re listening to your comments about AutoCAD 2013 Help. We are adding it to the valuable feedback we’ve already received from users who participated in our Beta program. I responded promptly to every comment from each Beta user and will now address a wider audience.
Here are some of the trends we’ve seen so far in the suggestions users are making about AutoCAD Help:
Additional navigation to supplement our Search function
Alphabetical listings of AutoCAD commands and system variables
Improved precision from the Search function
Access to information about new features
We are working right now on our update plans. We invite your additional comments … Full post →
Trying to be fair, I decided to put aside my initial hostility to the AutoCAD 2013 Help system and use it for real. I used it in a realistic situation, to find out how to work with something new or changed (model documentation) as I was working through it with my own example drawing. Try as I might to give it a fair go, I could only get so far before I got irritated. Using it in anger might not be an entirely appropriate phrase for it, but it’s not that far off. Using it in annoyance, perhaps? Here’s how it went.
I hit F1, wait for it to finish loading itself, click in the search box (because that’s not where the focus is to start with), type ‘model documentation’ and pick Search (because Enter doesn’t work). I then wait again, for about 10 seconds, even though I’ve configured it for offline use. … Full post →
There’s one important area in which AutoCAD 2013’s Help shines when compared with its immediate predecessors. If you’re a Visual LISP user, you’ll be pleased to know that if you select a function name in the editor (e.g. (vla-get-ActiveDocument)) and hit Ctrl+F1, this now takes you to the appropriate page in the ActiveX and VBA Reference, as it should. In AutoCAD 2011 you just got a cryptic message or a 404 error, depending on the context. In AutoCAD 2012, you were just taken to the front page of Help and expected to find it yourself. Props to Autodesk for fixing this problem.
As a bonus, the reference you’re taken to is still a CHM so it works nicely. The Search tab doesn’t work in Windows 7, but that applies to all CHM Help and it’s Microsoft’s fault, not Autodesk’s. The structured contents and index are fully functional, which makes the … Full post →
Autodesk has produced a 2-minute video explaining the features of the new Help system in AutoCAD 2013 that I recently panned. As you might expect, it’s kind of upbeat and chirpy, but the fact that Autodesk feels the need to provide a tutorial on how to use Help says it all, really. Whatever, it may be useful to you, so here it is. It’s hosted on the Autodesk site, unlike many other Autodesk videos (and my own, to be fair), so those of you who have YouTube blocked at work may still be able to watch it.
If you’re having trouble watching the tutorial, don’t panic. I expect Autodesk will soon produce another tutorial explaining how to use the tutorial explaining how to use Help explaining how to use the product to actually do work.
In AutoCAD 2011, Autodesk introduced on-line Help. It was badly done and poorly received. It was slow and generally awful to use, and so obviously inferior to the generally well-crafted old CHM-based system in so many ways, that there were squeals of joy when somebody discovered that one of the AutoCAD-based vertical products hadn’t been updated to the new regime and still provided a CHM file. That file became hot property, being posted by users on Autodesk’s own discussion groups and other places. Eventually, the outcry was loud enough that Autodesk was forced to make the CHM version of Help available for download. Those of us who actually use the documentation from time to time (or support people who do) breathed a sigh of relief and got on with our work, grateful that Autodesk had seen the error of its ways. But had it, really?
…the Ribbon, according to your selections in the What are the worst features ever added to AutoCAD?poll. As in the best ever poll, the winner (loser?) in this race had no serious competition. I’ve listed eleven top (bottom?) features here rather than ten, partly because the popular (unpopular?) choice Memory Overuse isn’t exactly a feature. But it’s mainly because I’d hate to see Action Recorder unfairly miss out on a well-deserved mention.
Help (on line / 2012) (18%)
Memory Overuse (17%)
AutoCAD Today (2000i/2002) (16%)
White / Cream Drawing Background (16%)
Unreconciled Layers (16%)
Proxy Object Compatibility (9%)
Action Recorder (8%)
Given the reception the Ribbon received when it was introduced, maybe it’s unsurprising to see it top the lists here. Cloud observers may find it interesting to note that that Autodesk’s … Full post →
You may have noticed that the much-derided AutoCAD 2011 Help has had something of an update for AutoCAD 2012, integrating it with something called Autodesk Exchange. Rather than critique this myself, I’ll hand it over to you.
What do you think of AutoCAD 2012’s Help? Is it all better now? Is it fast, accurate and easy to use with a useful search facility? Or do you hate it and hope someone at Autodesk is scrambling to create a CHM version of it like last year? Please comment.
As announced by Shaan Hurley, Autodesk has made some changes to the AutoCAD 2011 online Help system. Please check it out and see what you think. After a short time with it, here are my experiences using IE6 (yes, I know). As this is a dynamic system and dependent on browser characteristics, Internet connectivity and any changes Autodesk may make between me writing this and you reading it, your mileage will vary.
There are some cosmetic changes, including a fixup of the Autodesk logo in IE6 that was done a couple of weeks ago. Sadly, my pink Comic Sans logo has not been adopted. As I can’t do a direct side-by-side comparison with the pre-change setup under identical conditions, I can’t make a definitive statement about performance. I can say that it does appear to have improved somewhat. It now takes about 3.5 seconds from hitting F1 to seeing … Full post →
It was good to see Autodesk react to criticism of AutoCAD 2011’s browser-based Help with an acknowledgement of the problems and an attempt to provide a workaround by making a zip file of CHM files available for download. That’s much better than ignoring people’s concerns, denying the validity of those concerns or shooting the messenger, which has been known to happen in the past.
However, there are some holes in the workaround, only some of which can be filled.
Under 64-bit Windows 7, the Search pane is blank, as it is in the CHM Help for earlier releases on that platform. This is stated on the download page. Index works well, but Search doesn’t. As Search is one of the worst aspects of the browser-based Help, this is a rather unfortunate.
There is no obvious way of making the CHMs provide contextual help. Don’t bother pointing at acad181.chm … Full post →
Instructions: 1. Download the AutoCAD2011CHMHelp.zip to your local drive (such as My Documents\AutoCAD2011Help). 2. Extract the zip file to this same folder. 3. To access the CHM Help, you’ll need to click on acad181.chm or create a desktop shortcut.
You can also point to the locally installed HTML help by turning on the local help checkbox under Options, System. You can also access the PDF’s from the Online Help Home page under Online Resources. http://docs.autodesk.com/ACD/2011/ENU
Thanks, Diane! That saves people from having to do inconvenient and dodgy things like downloading a demo version of an AutoCAD … Full post →
My poll on this subject is still running (see right), but so far about 2/3 of respondents rate AutoCAD 2011’s new browser-based Help system as 0, 1 or 2 stars out of 5 (total fail, very poor or poor). Frankly, I’m surprised it’s doing as well as that. Have a look at this discussion group thread to get an idea of the sort of reaction I was expecting it to receive. (Kudos to Autodesk’s moderators for allowing the discussion to continue with relatively little obvious censorship, at least so far).
There are many good new things in AutoCAD 2011, but Help isn’t one of them. Even if you like the concept of online help, this implementation of that concept is a failure. Even when used offline, this release’s browser-based Help is manifestly inferior to its CHM-based predecessor. Yet another victim of the 12-month release cycle, this feature is horribly … Full post →
With all this talk of clouds in the air, it is interesting to note that Autodesk has moved AutoCAD’s Help system to a browser-based format, with online access as the default. So, how has Autodesk done with this first dipping of its toes into the cloudy waters with its primary mainstream product? I’ve already had a couple of unsolicited comments on the subject, and I’d like to hear from you. How do you rate the following, compared with previous releases?
Content completeness and accuracy
Ease of manual browsing
Efficiency of user interface
Concept of online Help
Anything else you want to mention
Please comment to express your views and use the poll on the right to provide an overall rating of the new system.