MathGroup Archive 2010

[Date Index] [Thread Index] [Author Index]

Search the Archive

Re: Frontend suggestions

  • To: mathgroup at smc.vnet.net
  • Subject: [mg111764] Re: Frontend suggestions
  • From: Murray Eisenberg <murray at math.umass.edu>
  • Date: Thu, 12 Aug 2010 05:32:10 -0400 (EDT)

There already is a "Possible issues" section on ref pages. Not that all, 
or even many, of the sort of "gotchas" you want are already there, but 
that's an obvious place for them. Perhaps, if you're going to use a 
Mathematica function seriously, you really should "devote enough time to 
really read through all of [the sections]" on that function's ref page.

On 8/11/2010 4:45 AM, AES wrote:
>
> ...Might seem more than enough -- in fact, too much, since no real person
> just wanting to get enough info to use a given command can devote enough
> time to really read through all of them.
>
> But still:  add an additional category to some (not all -- maybe just a
> few) documentation pages, where needed:  a category named something like
> "Warnings" or "Hints" or even "Gotchas", whose purpose would be just to
> give brief warnings about those gotchas that occur most frequently in
> connection with that particular command.

-- 
Murray Eisenberg                     murray at math.umass.edu
Mathematics & Statistics Dept.
Lederle Graduate Research Tower      phone 413 549-1020 (H)
University of Massachusetts                413 545-2859 (W)
710 North Pleasant Street            fax   413 545-1801
Amherst, MA 01003-9305


  • Prev by Date: Re: Collecting Positive and Negative Terms
  • Next by Date: Re: Clearing RAM Memory during evaluation
  • Previous by thread: Re: Frontend suggestions
  • Next by thread: Re: Frontend suggestions