• Open Menu Close Menu
  • Apple
  • Shopping Bag
  • Apple
  • Mac
  • iPad
  • iPhone
  • Watch
  • TV
  • Music
  • Support
  • Search apple.com
  • Shopping Bag

Lists

Open Menu Close Menu
  • Terms and Conditions
  • Lists hosted on this site
  • Email the Postmaster
  • Tips for posting to public mailing lists
Re: bad documentation
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: bad documentation


  • Subject: Re: bad documentation
  • From: "Tomas Zahradnicky, Jr." <email@hidden>
  • Date: Tue, 13 Nov 2001 11:03:48 +0100

> -- At the very top of every page of the doc, there is a two links
"documentation":"cocoa". YOU CANNOT follow them, because they correspond
to a link 'help:something' that no browser understand. (Okay there is Help
Viewer; who is laughing?) Even PB cannot follow one these link (the most
useful: coca).

We all agree that AppleHelp and HelpViewer are worthless. Apple should
remove these bogus links ASAP and replace them with useful links.

The documentation is made like other the USER documentation (Mac OS help, AppleScript,...). This is definitely bad. The helpviewer is a very simple app which and they extend it by launching applescripts to do work they cannot like opening files, filling the clipboard and so. Apple's very stupid with docs, because they don't want to license documentation to anyone. :( I used under classic to use think reference --- a lighting fast reference --- but, because of the apple's stupidity it is out of date (related to System 7). The helpviewer is really a bad joke... so slow and stupid application is an example how should documentation *never* be!

There are many alternative sources for this type of information. Search
with google.

Google is perfect. No spam, no ads, but requires you to be connected to the internet. Not everyone can be connected (due to high prices here, for example) to the internet all the time.

> > This topic is under construction.
> >
> No comment! (That's now more than one year that Mac OS X is out, remember
> ?)
>
> -- So to find useful information you MUST read the classes description.
OK. I don't anticipate this ever changing.

That's true. I just needed to manipulate some files and I this message made me quite angry.


-Tomas
--
# Tomas Zahradnicky, Jr
# The Czech Technical University
# FEL-CTU, Prague


  • Follow-Ups:
    • Re: bad documentation
      • From: Karl <email@hidden>
References: 
 >bad documentation (From: email@hidden)
 >Re: bad documentation (From: "Erik M. Buck" <email@hidden>)

  • Prev by Date: Re: Localized dates and times
  • Next by Date: Still about bad documentation
  • Previous by thread: Re: bad documentation
  • Next by thread: Re: bad documentation
  • Index(es):
    • Date
    • Thread