Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]


Groups > comp.soft-sys.math.mathematica > #14810

Re: Applications and Packages, WRI Strikes Out!

From Syd Geraghty <sydgeraghty@mac.com>
Newsgroups comp.soft-sys.math.mathematica
Subject Re: Applications and Packages, WRI Strikes Out!
Date 2013-06-11 06:26 +0000
Message-ID <kp6fv4$ndu$1@smc.vnet.net> (permalink)
References <komok1$1uv$1@smc.vnet.net>
Organization Time-Warner Telecom

Show all headers | View raw


Dear David,

On Jun 6, 2013, at 8:19 PM, djmpark <djmpark@comcast.net> wrote:

> The problem is that now the documentation methods are highly tuned for WRI's
> own requirements. The Workbench procedures for users appear to be a spinoff.
> They are not easily applied to the needs of Application development and use.
> The present WRI package and user documentation facilities are ill-designed,
> buggy, unintuitive and unstable. WRI has been dangling this out there for a
> number of years. It's time to finish the job and do it right.
>
>
> David Park
> djmpark@comcast.net
> http://home.comcast.net/~djmpark/index.html


There is a certain irony to be noted in reading Stephen Wolfram's latest blog on the history of Mathematica regarding the importance of documentation for users of Mathematica who wish to develop applications and extensions of the system for use by the Mathematica community.

http://blog.wolfram.com/2013/06/06/there-was-a-time-before-mathematica/

To quote Stephen from the blog:

"Meanwhile, just as for SMP, I'd assembled a team, and started the actual implementation of Mathematica. I'd also started a company this time with me as CEO. Every day I'd write lots of code. (And to my chagrin, quite a bit of that code is still running in Mathematica today, especially in the pattern matcher and evaluator). But my biggest focus was design. And following a practice I'd started with SMP, I wrote documentation as I developed the design. I figured if I couldn't explain something clearly in documentation, nobody was ever going to understand it, and it probably wasn't designed right. And once something was in the documentation, we knew both what to implement, and why we were doing it."

Clearly Stephen recognized and embraced 25 years ago the importance of Documentation in software system development. The irony is that Mathematica users 25 years on feel facilities for producing their own package documentation do not match the exemplary standards of so much else that we admire in Mathematica 9.

There may well be a lot of Stephen's original code still in the Mathematica Documentation facilities which might explain David's valid criticism of the present WRI package and user documentation facilities.


Cheers .... Syd

Syd Geraghty B.Sc, M.Sc.

sydgeraghty@mac.com

Mathematica 9.0.1 for Mac OS X x86 (64-bit) (January 24, 2013)
Release ID 9.0.1.0 (4055646, 4055073)
MacOS X V 10.8.2 Mountain Lion
Mac mini 6,2 Late 2012
2.6 GHz Intel Core i7, 8 GB 1600 MHz DDR3
Graphics  Intel HD Graphics 4000 768 MB

Back to comp.soft-sys.math.mathematica | Previous | Next — Previous in thread | Find similar | Unroll thread


Thread

Applications and Packages, WRI Strikes Out! "djmpark" <djmpark@comcast.net> - 2013-06-05 07:16 +0000
  Re: Applications and Packages, WRI Strikes Out! David Bailey <dave@removedbailey.co.uk> - 2013-06-06 11:23 +0000
    Re: Applications and Packages, WRI Strikes Out! Michael Weyrauch <michael.weyrauch@gmx.de> - 2013-06-07 03:16 +0000
      Re: Applications and Packages, WRI Strikes Out! David Bailey <dave@removedbailey.co.uk> - 2013-06-08 06:32 +0000
    Re: Applications and Packages, WRI Strikes Out! "djmpark" <djmpark@comcast.net> - 2013-06-08 06:33 +0000
  Re: Applications and Packages, WRI Strikes Out! David Annetts <david.annetts@iinet.net.au> - 2013-06-06 11:50 +0000
  Re: Applications and Packages, WRI Strikes Out! "djmpark" <djmpark@comcast.net> - 2013-06-07 03:15 +0000
    Re: Applications and Packages, WRI Strikes Out! David Bailey <dave@removedbailey.co.uk> - 2013-06-08 06:32 +0000
  Re: Applications and Packages, WRI Strikes Out! Syd Geraghty <sydgeraghty@mac.com> - 2013-06-11 06:26 +0000

csiph-web