I like tooltips. -- Raul
On Mon, Jan 31, 2011 at 10:04 PM, Devon McCormick <[email protected]> wrote: > 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 > ---------------------------------------------------------------------- For information about J forums see http://www.jsoftware.com/forums.htm
