10
$\begingroup$

Back in the day, I read the Mathematica Book cover-to-cover, and I found it to be an enlightening experience. I realize that the Documentation Center is now an order of magnitude larger than the Mathematica Book was, but suppose I wanted to undertake the quixotic task of reading through the complete Documentation Center anyway. What would be a way of navigating through it that would not:

  1. be unnecessarily convoluted;
  2. result in material being skipped;
  3. result in material being encountered repeatedly;
  4. result in material being encountered before its prerequisite material is encountered?

There are 21 colored tiles at the top level. Can I read completely through the material hidden under one tile before moving onto another tile, or are things too intertwined below the surface to make that feasible?

If there is no navigational strategy meeting the 4 criteria above, what are the best Mathematica 10 learning resources available for linear learners?

Updated to Add: I apparently should have stated specifically that I'm interested in the Documentation Center for Mathematica 10. I'm not interested in reading outdated documentation.

$\endgroup$
14
  • 1
    $\begingroup$ Type "virtual book" in the help search box. It will bring up a table of contents. You can use this table of contents as a linear organization of the material. There used to be a button for this in v9, I don't know where it went. $\endgroup$
    – Szabolcs
    Commented Jan 19, 2015 at 21:51
  • $\begingroup$ It appears to me that the Virtual Book doesn't contain all of the information in the Documentation Center. Where, for example, is anything on Computation with Structured Datasets? Has the Virtual Book been updated for v.10 at all? $\endgroup$ Commented Jan 19, 2015 at 22:03
  • 1
    $\begingroup$ See here $\endgroup$
    – user9660
    Commented Jan 19, 2015 at 22:04
  • $\begingroup$ That's essentially the same thing recommended by Szabolcs, so I'll ask you the same questions I asked him. Does the Virtual Book contain everything in the Documentation Center? Has it even been updated for v.10? $\endgroup$ Commented Jan 19, 2015 at 22:12
  • 3
    $\begingroup$ Not even the part of the documentation that talks about the Virtual Book and Function Navigator has been updated. Thing seem to be in a flux at the moment ... For functionality added before v10 the Virtual Book is your best bet. $\endgroup$
    – Szabolcs
    Commented Jan 19, 2015 at 22:13

1 Answer 1

14
$\begingroup$

First of all, in my opinion your criteria 4 cannot be achieved easily because there are a lot of cycles in the documentation and you find a lot of references and back-references in help-pages.

Otherwise, I agree that it is very helpful to have a linear way to go through all of the material of Mathematica. When you study the literature about how to read books and speed-reading, you often find that starting to really read the book is not the best option. A better way is to carefully study the index and afterwards skim through the material to get an overview because this helps the brain to classify the information.

What I like is to just read through the list of all Mathematica functions and if I encounter something that I didn't know yet (and which sounds interesting), to read through its documentation. If you want to do this, then there is an easy way to create an alphabetical list of all system functions and their link to the documentation directly within Mathematica:

docPath = FileNameJoin[{$InstallationDirectory, "Documentation", "English", "System"}];
Column[
 OpenerView [{Style[#1, "Item"], Column[Function[sym,
        Button[sym, Documentation`HelpLookup[sym], 
         Appearance -> "Frameless"]] /@ #2]}] & @@@ ({#, 
      Names["System`" <> # <> "*"]} & /@ 
    Prepend[CharacterRange["A", "Z"], "$"])
 ]

This gives you read through all function names and have their documentation by just clicking on them

enter image description here

Additionally, and this might be of equal importance, there is a way to display all guide pages, tutorials and how-to's in the same manner:

{guides, tutorials, howtos} = Map[FileBaseName, 
  FileNames["*.nb", {FileNameJoin[{docPath, #}]}]] & /@ {"Guides", "Tutorials", "HowTos"};
Column[OpenerView [{Style[#3, "Item"], 
     Column[Function[page, 
        Button[page, Documentation`HelpLookup[#1 <> page], 
         Appearance -> "Frameless"]] /@ #2]}] & @@@ {{"guide/", 
    guides, "All Guides"}, {"tutorial/", tutorials, 
    "All Tutorials"}, {"howto/", howtos, "All Howto's"}}
 ]

This is a lot to read and I recommend that you really skim through the lists first and not just start reading. For instance, I see about 50 tutorial about DSolve alone... To answer your questions with regard to my code:

  1. Going through the lists should not be convoluted at all.
  2. The reference pages are not complete, because I have only included everything from the system context which starts with a letter or with $. Therefore, you will skip for instance \[FormalS]. The tutorials, the guides and how-to's are extracted from the installation and should be complete (although it does not include add on packages).
  3. If you read from start to end, you should not see any page twice
  4. You will see functions in the documentation pages that you haven't see yet.

I hope you find this helpful.

$\endgroup$

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.