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 →
An interesting new feature of AutoCAD 2017 is Share Design View, which is invoked using the leftmost button on the A360 Ribbon tab or the ONLINEDESIGNSHARE command. The idea behind this command is to create a web-published snapshot of your drawing that can be accessed by anyone with a browser (they’ll need a fairly recent one).
This command works as advertised and provides another option to allow limited access to your design information without providing access to your DWG files. It creates a web page containing a view of your drawing and lets you have the URL (link) so you can access it. You can then share this URL with anyone you want to share the design with. They just follow the URL and can view the design using the Autodesk A360 Viewer (no download required).
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 →
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?
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 →
Credit where credit is due. Following my rant about the uselessness of using a 16-minute YouTube video as the AutoCAD 2011 system requirements resource, the relevant people at Autodesk quickly fixed it and let me know.
Now we just need the other releases covered and we’ll be all set. Autodesk is still officially supporting AutoCAD releases back to 2008, and those people who parted with a big slab of cash a decade ago are Autodesk customers, too. I’m sure Autodesk would like potential new buyers of its current products to know that they will be at least minimally looked after in future.
I commend Autodesk’s Leo Casado for reacting politely and constructively to what was undoubtedly harsh feedback. Some Adeskers (by no means all) have been known to get extremely defensive when faced with criticism, insisting that all feedback should be expressed constructively. That’s nonsense, of course. Frank … Full post →
This evening, I needed to know exactly which operating systems were supported by all AutoCAD releases from 2004 to 2011 inclusive. I have a pretty good idea, but I needed to confirm that my mental picture is completely correct. So I hopped over to the Autodesk Knowledge Base and entered “system requirements” in the search engine. Only one of the first 50 results was relevant, and that was for AutoCAD 2011. So I clicked on that. Did I get an easily digestible list of system requirements, including a list of exactly which operating systems were supported by AutoCAD 2011? No, I did not.
What I got was this:
So I clicked on the pretty picture, hoping to be taken to an easily digestible list of system requirements, including a list of exactly which operating systems were supported. Is … Full post →