MathGroup Archive 2007

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

Search the Archive

Re: Re: Version 6 "Mathematica Book" - updated


My feeling is that the tutorials in your chapter Further Tutorials are 
just waiting to be adapted to the overall stucture of documentation 
tutorials or to be removed. Your three main chapters are based on 
overview notebook files that have links to  other tutorials, all of them 
having a TOCTitle cell and lower level links in TOCSection, 
TOCSubsection, TOCSubsubsections cells. All these tutorials are found in 
the three main chapters of your virtual book.

The further tutorials have a different structure. First, there is no 
overview notebook containing a link to them. Then the relevant cells do 
not have a TOC-structure. When there is a title cell at all, the type is 
just Title. Moreover, when opened, some of them show the heading 
obsolete tutorial.

As far as I know, WRI is working very hard on the documentation an I 
expect that already in the next release we will have more overview 
notebooks on more topics (stylesheets!) than we have now. That will have 
an impact on your very useful virtual Mathematica book. But if that 
release will have THE Mathematica book again is another question. 
Personally, I feel no need for it and, like you, I am very happy with 
the new documentation center.

Fred Simons
Eindhoven University of Technology

thomas wrote:
> On Aug 13, 10:41 am, Murray Eisenberg <mur... at> wrote:
>> * thomas' code includes the unnecessary "New: " at the start of certain
>> section titles.  OK, I can live with that.
> The main reason I included the "New: " was that I myself decided where
> to put these chapters within "The Book", since these were not present
> in the v5.2 book. I wanted to give people an easy way to spot these
> chapters and move them to different places if it seems more
> appropriate that way. So far, nobody complained, so my choice wasn't
> that bad, it seems.
> This brings up another issue, however, which is the section I named
> "Further Tutorials" between "The Book" and the section with the
> "Package" documentation. Obviously, these tutorials fit somewhere
> within the natural flow of "The Book", but I didn't feel like going to
> the trouble to figure out where. Instead, I at least tried to divide
> them into topics. Some of these tutorials are quite basic, while some
> of them are very sophisticated indeed (like the ones about dynamic
> interactivity, or the one about Random Number Generation).
> In fact, I feel it should not be anybody's job to figure out the
> outline of where to place these tutorials, that should be done by the
> folks at WRI. Obviously somebody wrote those documents, it should not
> be too hard for the authors to place them appropriately within "The
> Book".
> So, maybe the next version of Mathematica Documentation Center will
> have "The Book" again, with proper placement of all tutorials. I have
> to say, I really do like the new documentation center with its many
> examples, it is just a shame that it hides these tutorials, which are
> really excellent documents, and obfuscates the natural order in which
> they were written and supposed to be read in (i.e. the order of "The
> Book").
> Thomas

  • Prev by Date: Re: listplot and legend (again)
  • Next by Date: Re: Foucault pendulum
  • Previous by thread: Re: Re: Version 6 "Mathematica Book" - updated
  • Next by thread: listplot and legend (again)