: Feedback on the design of a physics document I am not a designer, I am a physicist. Back in 2005, I made a guide for students about how to measure cosmic rays, for a lab class I was teaching.

@Annie732

Your design is great! If I were to publish, your book will be a standard I would try to achieve. Your introduction does your work no justice.

My preamble to my answer is "It has been 20 years since I have opened a style guide for writing." At least I have some recent relevant experience: I'll spend hours reading articles, books, and web pages to research our products.

My feedback on your specific questions:


Yellow in chapter titles is great; I agree with the comments in your question and add that I looked at the images before your questions and this appears natural and designed by paid designers.
Your list markers are not cheesy. I prefer the muted feel of the gray and the simple stars. Solid dots are very heavy; these points separate the information without intruding.
I did notice the red vs blue and appreciate the internal vs external hyperlinks. Good idea.
You are definitely not abusing the gray. It contains the idea presented within and prevents run-on. Without gray boxes, the two equations at the top of page 72 would feel more like steps of a proof rather than different concepts.
The code snippets are perfect and I appreciate the colored syntax highlighting. The line numbers help when the code is referenced. Specifically, you mention changing line 49. This dramatically speeds anyone trying to understand your code usage and the context of the software near it.
Tables: no need for making them "pop" so long as the information is delivered. I do have a suggestion about horizontal lines to improve readability (below).
The "Plateau" plot, without a grid, I spend a lot of time looking at one axis then the other to get a feel for the values.
Gray page numbers with chapter title is great. It should be harder to read than the body of the text. When the brain wants the page number, it is instantly recognizable and leaps from its background position (in gray color).




When looking at your pictures two style elements leapt out at me:


1: The bold font usage here feels informal. At the first glance, my thought was "oh no, not comic sans" and then I had to look again to realize this is simply the bold variant of the font used in the text. Even though I observe this to be standard practice in texts, I've always disliked it and makes me want to skip those sections/paragraphs entirely.

I'd rather see the all caps usage from your table example or use the bold font from your Table 4.3 description.




2: Please, please, please add horizontal lines in your tables. One topic of my recent research literally had me trying to read tables identical to yours for hours in attempt to quantify the physical properties of various vendors' polyethylene. It was bad enough there were multiple units of measurement, but having to get a ruler to ensure I have the correct line was maddening.

My personal style for tables like this is to group three rows at a time. The table isn't full of lines yet figuring out which line of data I want is easy. Excuse the low quality of gray lines, this is an example:

Vote Up Vote Down