Search

Filter

  • Advanced Filters:

  • to
  • Specific Data Sources:

    All Edit

    Select All  |  Select None

Reset filters

E rru rs By G e r a l d M. W e i n b e r g T h i s is the first e d i t i o n of a new f e a t u r e in *, the E r r u r s Column. Each issue, we will f e a t u r e an errur c o n t r i b uted by one of our readers, or t a k e n from the e d i t o r ' s v o l u m i n o u s file of idiocies. What w e ' r e l o o k i n g for is bad e x a m p l e s of d o c u m e n t a t i o n , each of w h i c h c o n t a i n s a m o r a l for our vast readership. Here a r e some e x a m p l e s of what w e ' r e after: I. u n f o r t u n a t e l y c h o s e n examples, w h i c h c o n f u s e ins t e a d of c l a r i f y i n g 2. unfortunate grammatical constructions that are easily misread the picture that's worth 1,000 words--to correct the confusion it creates completely empty explanations that purport to be saying something Sources will be kept confidential, if requested. The Editur will edit, unless requested not to. Joe Rigo requests that nobody use his manuals for case material. ERRUR OF THE BI-MONTH Because of all that explanation above, here's a short classic from IBM's immortal OS/360 Error Messages: IBC218W INVALID Explanation: has occurred. ERROR. An invalid error return 3. IBC219W WRONG ERROR. Explanation: The error return is valid but is not associated with the specified device. 4. Don't let your imagination be limited by this list. Send in your favorite, h o p e f u l l y w i t h some high m o r a l lesson y o u ' v e been able to a b s t r a c t from it. Contributions go to the E r r u r s Editur: G e r a l d M. W e i n b e r g E t h n o t e c h , Inc. Rural Route Two Lincoln, NE 6 8 5 0 5 MORAL: What the system gives the user is the primary documentation. If that contains moronisms like WRONG ERROR or INVALID ERROR, trying to explain can only make it worse. Get the system changed, or else write: Explanation: I f you g e t t h i s m e s s a g e , it's b e c a u s e t h e p e r s o n who p r o g r a m m e d t h i s p a r t o f t h e s y s t e m was n o t d o i n g a professional job. -19-

Page 1 of 1

Page 1 of 1

Toggle back to continuous viewing mode

/lp/association-for-computing-machinery/errurs-vq2gbYuAij
Welcome to DeepDyve! Rent Premier Research Articles and Save Up to 90%

Learn more

Free Article

Bookmark

Errurs

Weinberg, Gerald M.
ACM SIGDOC Asterisk Journal of Computer Documentation , Volume 5 (3)
Association for Computing MachinerySep 1, 1978

More Info

More Like This Article

View All dataSource[]=actageo&dataSource[]=aspet&dataSource[]=aaos&dataSource[]=aacc&dataSource[]=aacr&dataSource[]=aea&dataSource[]=aip&dataSource[]=ajnr&dataSource[]=ams&dataSource[]=aps_physical&dataSource[]=appi_book&dataSource[]=appi_journal&dataSource[]=apha&dataSource[]=asip&dataSource[]=asm&dataSource[]=asn&dataSource[]=aspb&dataSource[]=avs&dataSource[]=annual_reviews&dataSource[]=arxiv&dataSource[]=acm&dataSource[]=berghahn&dataSource[]=cabi&dataSource[]=clinical_trials&dataSource[]=dailymed&dataSource[]=degruyter&dataSource[]=du_press&dataSource[]=esa&dataSource[]=eu_press&dataSource[]=elsevier&dataSource[]=emerald&dataSource[]=ejtr&dataSource[]=emea&dataSource[]=epo&dataSource[]=faseb&dataSource[]=gsa&dataSource[]=health_affairs&dataSource[]=hindawi&dataSource[]=imanager&dataSource[]=imedpub&dataSource[]=informa_healthcare&dataSource[]=informs&dataSource[]=iop&dataSource[]=iucr&dataSource[]=iospress&dataSource[]=jbjs&dataSource[]=leftcoast&dataSource[]=lu_press&dataSource[]=mesharpe&dataSource[]=mary_ann_liebert&dataSource[]=medline&dataSource[]=mit_press&dataSource[]=nature&dataSource[]=oxford&dataSource[]=pier_professional&dataSource[]=pnas&dataSource[]=portlandpress&dataSource[]=psyc_articles&dataSource[]=psyc_books&dataSource[]=psyc_critiques&dataSource[]=plos_journal&dataSource[]=pubmed_central&dataSource[]=rsna&dataSource[]=rockefeller&dataSource[]=rcn&dataSource[]=ria&dataSource[]=rsc&dataSource[]=sage&dataSource[]=spie&dataSource[]=springer_journal&dataSource[]=springer&dataSource[]=taylor_francis&dataSource[]=aps&dataSource[]=the_scientist&dataSource[]=uc_press&dataSource[]=uspto_abstract&dataSource[]=wiley&dataSource[]=pct

Browse: Subject Areas | Journals | Publishers

Sign Up for a DeepDyve Account

Bookmark an Article

To bookmark an article, please log in first, or sign up for a DeepDyve account if you don't already have one.

OK

Subscribe to Journal Email Alerts

To subscribe to email alerts, please log in first, or sign up for a DeepDyve account if you don't already have one.

OK

Thank you for renting with DeepDyve

Your PayPal account has been charged $2.99. You now have access to the full text of this article. A rental receipt has also been sent to your email address.

Your credit card has been charged $2.99. You now have access to the full text of this article. A rental receipt has also been sent to your email address.

OK

New! You can now keep track of new articles from ACM SIGDOC Asterisk Journal of Computer Documentation on your personalized homepage! Learn more

PDF Download — Not Available

Thanks for your interest in purchasing the PDF. Your request has been noted and we will work with our publisher partner to discuss enabling this feature.

In the meantime, you can get the PDF by visiting the publisher site.

Thank you for purchasing with DeepDyve

Your PayPal account has been charged $.

Your credit card has been charged $.

You can now download this article. A purchase receipt has also been sent to your email address.

Download This Article or I'm done with my download

Print Page — Not Available

Thanks for your interest in printing individual pages. Your request has been noted and we will work with our publisher partner to discuss enabling this feature.

In the meantime, you can get the PDF by visiting the publisher site.

Thank you for printing with DeepDyve

Your PayPal account has been charged $0.

Your credit card has been charged $0.

You can now print this article. A purchase receipt has also been sent to your email address.

Print the Selected Pages or I'm done with my printing

Please refresh to generate a new download link

Your article download link has expired. Please refresh this page to obtain a new download link and try again.

Follow a Journal

To get new article updates from a journal on your personalized homepage, please log in first, or sign up for a DeepDyve account if you don't already have one.

OK