From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=ham autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,cec04f9d45b3f527 X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 2003-09-02 00:40:58 PST Path: archiver1.google.com!news1.google.com!newsfeed.stanford.edu!news-spur1.maxwell.syr.edu!news.maxwell.syr.edu!newsfeed.icl.net!newsfeed.fjserv.net!colt.net!news.tele.dk!news.tele.dk!small.news.tele.dk!fu-berlin.de!uni-berlin.de!tar-alcarin.cbb-automation.DE!not-for-mail From: Dmitry A. Kazakov Newsgroups: comp.lang.ada Subject: Re: An Ada advocacy method Date: Tue, 02 Sep 2003 09:47:53 +0200 Message-ID: <7gh8lv84kq46bjfo5pd1185bdtfn01e78d@4ax.com> References: <3F4F4817.7030306@noplace.com> <3F50130A.1070406@noplace.com> <3F50A70E.7050809@noplace.com> <3F521B65.1090004@noplace.com> <20030831123103.43926d87.falis@verizon.net> <3F535639.9060008@noplace.com> <3F53EDE8.6090908@noplace.com> NNTP-Posting-Host: tar-alcarin.cbb-automation.de (212.79.194.111) Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Trace: news.uni-berlin.de 1062488454 14827904 212.79.194.111 (16 [77047]) X-Newsreader: Forte Agent 1.8/32.548 Xref: archiver1.google.com comp.lang.ada:42055 Date: 2003-09-02T09:47:53+02:00 List-Id: On Tue, 02 Sep 2003 01:10:15 GMT, Marin David Condic wrote: >Documentation can only be as good as the writer. Let's put this in >perspective. Take your average program in your average editor and >highlight some system provided subroutine and hit the "Help" key. If you >got nothing, that's pretty typical and usually pretty useless. If you >got a single sentence saying "This is the gazorenthorpe subroutine", you >got something close to useless. If it gave you a page that described >what the subroutine is supposed to do and what the parameters are >supposed to be and maybe an example or two of proper usage and perhaps >some links to similar or related subroutines, you got something that is >a damned sight better than "nothing" or a single sentence. > >Microsoft may not have written Shakespearian quality documentation, but >in my book, something more than "nothing" is pretty nice to have. In all >my usage of MSVC++ and my many trips into the documentation, I usually >could find out what the average programmer needed to know in order to >use some provided feature and that's a reasonable definition of >"thorough" so far as I can tell. It is true what you are saying. But two small corrections: 1. F1 does not work in MSVC any more. The new versions of MSDN do not support it. 2. When you press F1, and it miraculously works, you will most probably get help for Visual Basic, Visual FoxPro, Commerce Server, Visio automation, Direct X, Windows CE, MFC and all sorts of other damn interesting, but pretty useless in the context things. It is much like Google search. Yes Microsoft documentation definitely was not written by Shakespe. It rather looks like being written by that famous troop of monkeys, which should probably reach a Shakespearian quality before the Entropic Death, or probably not. (:-)) --- Regards, Dmitry Kazakov www.dmitry-kazakov.de