My feeling is that short is better, especially when full info is just an
experimental click away.
The full context on that page (relatively unchanged for a few releases) is:
***
There are 7 books (User, Primer, J for C Programmers, Learning J, Phrases,
Dictionary, Release). Every page has standard jumps:
>> next, << previous
Usr Pri JfC LJ Phr Dic and Rel to that contents
Voc to Vocabulary, !: to Foreigns
Help jumps here and the current book is at the end
On Mon, Jan 31, 2011 at 9:35 PM, Devon McCormick <[email protected]> wrote:
> I'm attempting to look at the new release as though I'm a beginner by going
> through the learning materials and I noticed that the "Help" page has the
> cryptic and ungrammatical line:
>
> Usr Pri JfC LJ Phr Dic and Rel to that contents
>
> where something more like this would be more informative:
>
> Section Description
> ---------- ----------------
> Usr User Guide - introduction to invoking J, system-level
> programming information
> Pri J Primer - complete introduction to language from first
> principles, with learning checkpoints
> JfC "J for C Programmers" - extensive introduction assuming prior
> experience with another programming language (not necessarily C)
> LJ "Learning J" - another extensive introduction arranged
> according to J language structure
> Phr Phrases - a more mathematically-oriented introduction to the
> language with sections on permutations, statistics, and finance.
> Dic J Dictionary - comprehensive overview based on learning by
> example
> Rel Release Notes for current and previous releases, detailing
> changes for each
>
> --
> Devon McCormick, CFA
> ^me^ at acm.
> org is my
> preferred e-mail
> ----------------------------------------------------------------------
> For information about J forums see http://www.jsoftware.com/forums.htm
>
----------------------------------------------------------------------
For information about J forums see http://www.jsoftware.com/forums.htm
