I'm all in favor of succinct expression but it might be clearer that the short names relate to the seven books. Perhaps all that needs to be done here is to re-order the sentences so that the abbreviations immediately follow the mention of the books without the interruption of the unrelated navigation information.
On Mon, Jan 31, 2011 at 9:41 PM, Eric Iverson <[email protected]>wrote: > 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 > -- Devon McCormick, CFA ^me^ at acm. org is my preferred e-mail ---------------------------------------------------------------------- For information about J forums see http://www.jsoftware.com/forums.htm
