Nice work Viktor and Henry! Responses inline. > On Aug 4, 2022, at 08:01, Henry Rich <henryhr...@gmail.com> wrote: > > 1. In each document, look at a couple of tables with a footnote, and refer to > the footnotes. Which layout did you find easiest to use? > a. footnotes at bottom, 1 column > b. footnotes at bottom, 3 columns > c. footnotes below each table c. much easier to reference > > 2. What do you think of the size of the main text? > a. too small > b. about right > c. could be smaller b. I viewed it as a pdf and so I can adjust screen zoom to whatever size I want. The current size was fine and needed no adjustment > > 3. What do you think of the size of the footnote text? > a. too small > b. about right > c. could be smaller b. I would not make it smaller > > 4. What do you think of the coloration (indicating part of speech)? > a. don't like it > b. no opinion > c. like it c. It is good for those with colour acuity (such as myself) Perhaps a legend box to indicate the colour correspondence for beginners who may use the reference? > 5. Consider the two tables 'Adverbs' and 'Conjunctions'. The adverb table > has a column of menmonic names, the conjunction table does not. Are the > names helpful? > a. no > b. no opinion > c. yes, for the adverbs > d. yes, and I would like to see names added for the conjunctions > e. yes, and I would like to see a mnemonic name for every primitive d. I think that finding names is often when I would use a quick reference. Many of the other primitives are either explained by mathematical notation or in the description of the result, so all primitives might be overkill (but, if there were space, probably should be included). > > 6. In the Foreigns table, would you prefer to see the system-defined name in > addition to/instead of the m!:n value? > a. m!:n only > b. both > c. system name only b. > > 7. Do you have suggestions for formatting? Write them in.
From what I can see, Box Ops and Multithreading tables are only on the 'footnotes for each table' version. the Box Ops table footnote refers to 'D' and I think that it should refer to 'B' which is used in the table itself. There is also some whitespace created in the width of the columns that might be eliminated. This is my main reason for preferring the 'Constant' table in the footnotes at the bottom versions. Other examples of 'wide' columns are in Multithreading where the last row could be broken into two with a line feed before 'creating a pyx' and the word 'Check' could be removed from the 'Foreigns' table. Thank you again for doing this. It is an exceedingly difficult task to decide what is both essential and sufficient. I also appreciate crowd sourcing the draft to get a wider perspective. Well done! Cheers, bob ---------------------------------------------------------------------- For information about J forums see http://www.jsoftware.com/forums.htm
