HOME  |  NEWS  |  BLOGS  |  MESSAGES  |  FEATURES  |  VIDEOS  |  WEBINARS  |  RESOURCE CENTER  |  INDUSTRIES
REGISTER   |   LOGIN   |   HELP
Comments
View Comments: Newest First|Oldest First|Threaded View
<<  <  Page 2/3  >  >>
Jon Titus
User Rank
Blogger
Re: Documents and manuals need an index
Jon Titus   8/15/2012 12:50:47 PM
NO RATINGS
Old_Curmudgeon: I second your complaints about part numbers and descriptions in print catalogs and online catalogs.  Even the manufacturers of products screw up part numbers and call something an ABC-123 in a press release when the true part number looks something like ABC12x, where x can represent several part families and they have dropped the hyphen.  This situation comes up more often than people might think.

OLD_CURMUDGEON
User Rank
Platinum
Re: Documents and manuals need an index
OLD_CURMUDGEON   8/15/2012 12:43:16 PM
NO RATINGS
Jon,

There are several other (print) catalogs that I rate very highly also, including the GRAINGER catalog, the MSC INDUSTRIAL SUPPLY catalog, and several electronic supply catalogs (MOUSER, ALLIED, NEWARK, to name a few).  Mentioning the McMASTER CARR catalog was just a "for instance" moment.  But, I can tell you one thing, and maybe this is because of my age, I usually get VERY frustrated searching manufacturers' wesite-based catalogs.  More often than not, the format of a part number in their e-database is different from the way it is printed on the item, OR as it appears in a (print) catalog.  One can be driven to total distraction because of a misplaced emdash, or other diacritical mark!  And, my final "beef" is that with print catalogs, I can make notes in the margins, circle important data parameters, etc.  Unless I print a page from the online catalogs, I have to make some other arrangement to store that info in the project folders. 

Ann R. Thryft
User Rank
Blogger
Re: Documents and manuals need an index
Ann R. Thryft   8/15/2012 12:32:19 PM
NO RATINGS
I agree with Jon about the need for manuals to include cross-references, or better yet, a glossary that defines terms and indicates which terms mean the same thing. That would be a huge help.

Ann R. Thryft
User Rank
Blogger
Re: Two mistakes save the day
Ann R. Thryft   8/15/2012 12:27:40 PM
NO RATINGS
You're right about that. I was thinking of more complex problem-solving and/or assembly projects. OTOH, I generally use the same approach even when putting together furniture--yes I still use those, all bookshelves--even though I'm really familiar with all the screw and connector types, and generally what can go wrong.

Rob Spiegel
User Rank
Blogger
Re: Two mistakes save the day
Rob Spiegel   8/15/2012 12:21:08 PM
NO RATINGS
I think a lot of this depends on what you're working on. In the description of the systems Jon Titus describes, instructions are critical. When I'm putting together toys for the kids, it's pretty intuitive.

Ann R. Thryft
User Rank
Blogger
Re: Two mistakes save the day
Ann R. Thryft   8/15/2012 12:15:46 PM
NO RATINGS
Rob, it's preventive medicine and hindsight. I had some experiences way back where I did the dive-in approach and was not happy with the results. Doing things over due to lack of preparation or foresight is not my idea of fun. It's much more fun and challenging to concentrate on solving the problem, or finishing the assembly, than stopping multiple times to move the project, or go to the hardware or electronics store for parts. I know some things, like plumbing repairs, by definition require multiple iterations in terms of part sizes or types. So those go to a plumber (or my husband).

Jon Titus
User Rank
Blogger
Re: Documents and manuals need an index
Jon Titus   8/15/2012 11:16:50 AM
NO RATINGS
Thanks for your comment.  I'll have to get a copy of the McMaster Carr catalog and take a look. --Jon

OLD_CURMUDGEON
User Rank
Platinum
Re: Documents and manuals need an index
OLD_CURMUDGEON   8/15/2012 8:42:59 AM
NO RATINGS
Jon,

One of the BEST "books" containing an index is the McMASTER CARR SUPPLY catalog.  There is so much redundancy that it is almost sickening, but as was posted, one person's widget might be someone else's doohickey.  Nevertheless, they both exist in that index.  Sure makes life a lot easier when poring through a catalog of 5,000 + pages.

Jon Titus
User Rank
Blogger
Documents and manuals need an index
Jon Titus   8/14/2012 7:03:26 PM
NO RATINGS
Manuals should have a good index with cross references.  What someone thinks of as a temperature sensor, someone else might think of as a temperature switch or temperature detector.  So listing all three in an index helps people get to the information no matter what they call something. Indexing requires patience and thoroughness.

I find the lack of cross references particulary troublesome in software books and documents.  In a C-language reference book I use often, I find two references to hexadecimal numbers and hex numbering in the index. But no reference to how to format data to display it in as hex values. In a perfect world, the index would include: 

hexadecimal, printing of

hexadecimal, display of

Under the heading of printf my book's index points to pages about printing floating-point numbers and strings, but nothing about other formats such as scientific notation or octal. An index makes or breaks documentation.

Jon Titus
User Rank
Blogger
Re: Two mistakes save the day
Jon Titus   8/14/2012 6:46:49 PM
NO RATINGS
Debugged might work--it's not used solely for software.

<<  <  Page 2/3  >  >>


Partner Zone
Latest Analysis
We looked at a number of sources to determine this year's greenest cars, from KBB to automotive trade magazines to environmental organizations. These 14 cars emerged as being great at either stretching fuel or reducing carbon footprint.
Doodle3D brings your 2D sketches to life.
Researchers at MIT and Sandia National Labs have observed a reaction in lithium-air batteries that could help improve the design of these cells for electric vehicles and other applications.
Healthcare might seem to be an unlikely target application for the Internet of Things technology, but recent developments show small ways that big-data is going to make an impact on patient care moving into the future.
The power windows were working as they were supposed to. That was one problem. Operator error was the other.
More:Blogs|News
Design News Webinar Series
5/15/2013 11:00 a.m. California / 2:00 p.m. New York / 7:00 p.m. London
5/22/2013 9:00 a.m. California / 12:00 p.m. New York / 5:00 p.m. London
5/29/2013 11:00 a.m. California / 2:00 p.m. New York / 7:00 p.m. London
5/30/2013 11:00 a.m. California / 2:00 p.m. New York / 7:00 p.m. London
Blogs from Our Sponsors
From Dell / Intel®
New Paradigms in Design Work
Scott Hamilton, vertical market strategist for Dell Precision workstations, 5/2/2013    3
Early in my career, I worked as a draftsman and remember the days of drawing on vellum with numbered pencils and Mylar with plastic lead. This was a fun experience in the sense that I ...
From Dell / Intel®
Increased Workstation Performance Is as Easy as 'DPPO'
Trey Morton, Dell, 4/25/2013    2
I've been using workstations for more than 10 years and love finding ways to get more performance from my system. With demanding professional applications that require more power each ...
From Dell / Intel®
Taking Some of the Grit out of Manufacturing
Kirsten Billhardt, Manufacturing Industry Marketing Strategist, Dell, 3/26/2013    5
A lasting memory from my first job as an engineer in an auto assembly plant is standing on hard concrete at six in the morning, vending-machine coffee clutched in hand, listening to ...
Quick Poll
The Continuing Education Center offers engineers an entirely new way to get the education they need to formulate next-generation solutions.
May 20 - 24, Automation Technologies & Trends for Smarter Homes & Buildings
SEMESTERS: 1  |  2  |  3


DN Radio
Sponsored by
NEXT UPCOMING BROADCAST
A quick look into the merger of two powerhouse 3D printing OEMs and the new leader in rapid prototyping solutions, Stratasys. The industrial revolution is now led by 3D printing and engineers are given the opportunity to fully maximize their design capabilities, reduce their time-to-market and functionally test prototypes cheaper, faster and easier. Bruce Bradshaw, Director of Marketing in North America, will explore the large product offering and variety of materials that will help CAD designers articulate their product design with actual, physical prototypes. This broadcast will dive deep into technical information including application specific stories from real world customers and their experiences with 3D printing. 3D Printing is
Twitter Feed
Design News Twitter Feed
Like Us on Facebook

Sponsored Content

Technology Marketplace

Datasheets.com Parts Search

185 million searchable parts
(please enter a part number or hit search to begin)
Copyright © 2013 UBM Canon, A UBM company, All rights reserved. Privacy Policy | Terms of Service