Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]
Groups > comp.soft-sys.math.mathematica > #14810
| 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 |
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
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