Every Page is Page One

Just about all of you reading this know that I am a technical writer. One of the things I do to keep up to date with the latest trends in the field is read. I read books, articles, blogs, whatever I can find that relates. I especially enjoy Mark Baker’s blog, Every Page is Page One. Baker consistently posts articles that make me think, and in good ways. When I heard he has a book out, I contacted the publisher immediately.

As a side note, Baker’s publisher, XML Press, consistently produces books that I find useful. Every one I have read is well-written, authoritative, and filled with real-world experience and practicality.

Every Page is Page One: Topic-based Writing for Technical Communication and the Web shares the first part of its title with the blog, but the content is not directly from the blog. Rather than a collection of posts on assorted topics assembled into book form, this is a well-thought-out and well-organized text. In it, Baker observes that documentation projects tend to think about technical writing from a very book-centered paradigm. This was once ideal, but in the age of communicating technical information electronically, it forces limits on the end product that hinder the true goal of technical writing, the goal of delivering the right information at the right moment to the person who is seeking it. As someone who is not only a technical writer, but who also has a degree in information resources and library science, I have multiple reasons for supporting this goal.

What Baker does is give tangible form to thoughts and ideas that he, other technical writers, and even I have had in the abstract. How do we provide needed information to people who seek it in an age where the web makes almost anything searchable? Do manuals still matter? What about other forms of documentation? Are there changes to our style of communication, to our style of writing and presenting information, that will make the information seeker’s task easier? Baker discusses serious and realistic ways we can improve our field. It is all organized around the idea that we can no longer control the order in which information seekers will consume or even find our information, that every page (in a documentation wiki, for example) should be created in a way that enables a user to immediately understand and acquire what they need when they need it. Since we know we do not have this control like we had in a printed book, we must modify how we write and present information to fit the expectations of the seeker.

I enjoyed reading this book. I have benefited personally from reading this book. I am taking this book in to my workplace and sharing it with the other tech writers there and I believe our workplace and our employer and our customers will benefit from this book. If you work in the field, I’m convinced you will, too. The whole book is good, but my favorite parts are Section I, which lays the foundation in five chapters, and Chapter 22, which gives very practical and useful advice for making your case to others when you begin to try to make the changes the book describes.

Disclosure: I was given my copy of this book by the publisher as a review copy. See also: Are All Book Reviews Positive?

American Nations

I don’t review everything I read. Not by a long shot. I generally have 3 or 4 books being read at the same time stashed in different places in my house. Today’s book is one that I bought and that I think deserves a wider audience. It begins by separating the idea of nations from states. Nations are essentially groups of people who share a common culture, ethnic language, or historical experience. States can be made up of nations, as in the nation-states of historic France or Turkey, but nations can exist outside of states, such as the Kurdish or Palestinian nations today.

American Nations: A History of the Eleven Rival Regional Cultures of North America postulates that North America, including Canada, the United States, and Mexico (at least the northern part), is made up of eleven nations, each with its own unique historical roots, norms, mores, and cultures and that it is the differences between these nations that create the political and occasionally violent turmoil in the region, especially within the United States.

The author uses a historical narrative to describe the beginnings of each nation, and specifically the reasons its founders felt it necessary to leave their established homes elsewhere and settle in a new land. Some wanted to create religious utopias. Others wanted to escape the control of tyrants. Still others wanted to find a land that they themselves could control as new tyrants, feudal masters of their own hierarchical kingdoms. Native Americans are not forgotten, but just as in history, they are primarily relegated here to the role of conquered indigenous and their histories and interactions are mostly, but not completely, ignored except to factually and clearly describe the dastardly ways with which native peoples were usually treated.

Maps from the book have been published in articles like this one from Tufts Magazine from Tufts University and are worth a look at this point in the description. The linked article also gives a listing and short description of each nation, long enough to give a sense of the idea, but not enough to give the full argument.

The book has left me with several takeaways, and these are why I think it is worth reading for anyone with an interest in North American, and especially USA history, politics, and culture.

  • Talking about red states vs blue states or Republicans vs Democrats or even The North vs The South forces extreme simplification of more complex issues, beliefs, and trends.
  • Thinking that “everyone in the Midwest” USA thinks or believes the same is naive–this is actually one of the more diverse sections of the country, which is why it always seems to be the power broker or swing voting area. In fact, it has historically been the buffer between the Yankee north and the Deep South extremes of the spectrum on almost every debate.
  • American history is presented very differently to children in each of these national areas. The obvious example is that what people who grew up in Yankeedom call “The Civil War” is called “The War Between the States” in the Deep South and often also in Tidewater and Greater Appalachia. However, this is only an obvious example and are there many less-obvious examples that I didn’t realize exist.
  • The men who made the decisions while creating the United States of America as a state sharply disagreed on many issues and for its first hundred years it was not certain the state would persist.

American Nations gives a clear description of each group, its stated motives, and its actions and uses these to dispassionately explain thought and voting trends and more across the areas. It follows these across time as historical events unfold that cause power to rise and fall, especially as the nations expand geographically and how each chose to do so–note, each nation did so very differently from the others. The intent is to help the reader grasp the layers of meaning, communication, alternate understandings and perceptions of events that make up the continent and especially the United States. Knowing this helps both the insider and the outsider grasp the difficulty inherent in trying to unite people across the nations toward any common goal.

As a supplement to a typical (lacking) education in North American and especially American history, I consider this book a quality companion to Howard Zinn’s A People’s History of the United States; this book is less political, but I don’t think it will be less transforming for the reader.

Disclosure: I was NOT given my copy of this book by the publisher as a review copy. See also: Are All Book Reviews Positive?

The LEGO Adventure Book, Volume 2

One more post before the holidays. I reviewed the first volume in this series just about a year ago in a post that covered three LEGO-related books.

The LEGO Adventure Book, Volume 2 is another hardcover book. This time, the volume includes a series of about 40 step-by-step building guides that are similar to what is provided when you buy a LEGO kit and pictures of many more built models for further inspiration. What I said about the first book in the series also applies here, so I’ll start off by quoting myself:

The illustrations in this book are stellar and the models are outstanding. Anyone looking to be inspired to build more interesting and more beautiful things will find this book thrilling. The book follows a loose story line focused on an adventure, a quest to learn how to build interesting and complicated things with LEGO. The story line is neither vital nor distracting, it just gives an fun excuse to move from idea to idea. This is [another] book that I expect my kids to enjoy (ages 8, 10, and 11).

If you liked the first volume, you will like this one. Along with the abundance of new ideas and building guides, there are some subtle refinements to the presentation that make this sequel even more enjoyable than the first volume. For one, there is a new focus on imagination with a limited palette, such as when a builder has only a few LEGO parts to work with rather than a limitless supply. This is a nice touch as it helps with a positive “I can do it” attitude rather than the common sales tactic that starts by building a sad “I don’t have the parts they have” feeling in the builder. To be sure, there are plenty of LEGO pieces in the examples that the reader may not already have, but they are not to focus; the focus is being creative and inspiring the reader. I like that.

The examples and projects are fun, diverse, colorful, and just all-around cool. In addition to the step-by-step instructions for specific projects, like Havoc: A Viper Fighter, where the reader learns how to build one form of space fighter, there are also follow-up pages that break the idea down to the important bits like A LEGO Viper should have… and a list. Then, there are lots of pictures of variations on this theme that use the same basic set of foundational parts to create a wide set of options and variations. This builds on the theme I mentioned above of avoiding the marketing evil of creating discontent and instead using simple basic things to get builders started and then building creativity.

The book contains large projects and small ones. There are space-based builds, earth-based, fantastic and realistic, futuristic and nods to the past. You will build cars, boats, planes, spaceships, homes, businesses, furniture, island getaways, castles, gardens, movie sets, kitchens, and some things I don’t even have words to describe or categories to name. The variety is great.

I have reviewed a lot of LEGO books this year. This is one of my favorites. It just came out, the copyright date says 2014, but I’m pretty sure I’ve seen this at the local bookstore. It is worth a look if you have a LEGO builder on your shopping list.

Disclosure: I was given my copy of this book by the publisher as a review copy. See also: Are All Book Reviews Positive?

Trinity: A Graphic History of the First Atomic Bomb

This is one of those books that is hard to categorize. It is alternately fascinating and disturbing, historically important and tragic, accessible and thought-provoking. This is a perfect mix of what I think we should feel when confronted with the history of The Manhattan Project and the world’s entry into the Atomic Age.

Trinity: A Graphic History of the First Atomic Bomb strives and succeeds at two tasks. It tells an accurate history of the facts and events leading up to the creation of the first atomic bomb through its use by the United States in the destruction of the Japanese cities of Hiroshima and Nagasake. It also successfully prompts the asking of philosophical questions that humanity must wrestle with when faced with such destructive power.

Throughout the black and white illustrated book, the graphics are clear and compelling. You feel the emotions of each moment, the fears and the excitement, the hope and the despair. You look into the eyes of the participants and feel their complexity and depth. This set of people were not monochrome in their beliefs, but complex and this comes through.

The events are told clearly, using a linear style that also incorporates both flashbacks and foretelling. It does so to great effect. Throughout, we get just enough scientific explanation to make the complexity of the topic clearer, using descriptions that are easy to understand while also technically accurate and complete enough to be meaningful.

All this is good. But there is one thing that this book accomplishes that is even better. It makes you think. This is no mere scientific or historic text, although it is both of these. It is also a philosophical springboard to deep meditation. This is a very good thing. You start by feeling alongside the participants the excitement of a scientific quest as they ask, “Can it be done?” You end with the same question most of them ended with, “Should it be done?”

Disclosure: I was given my copy of this book by the publisher as a review copy. See also: Are All Book Reviews Positive?

HTML 5 Unleashed

I previously reviewed some books on HTML5 and CSS3, but that was back in 2011. This is a brand new book on HTML5. It doesn’t cover CSS3, but it covers the HTML specification in greater detail than the other two books.

HTML5 Unleashed is part of the same series as my book, Ubuntu Unleashed 2014 (which is brand spanking new as well…just saying…). I’m stating that right up front so that everyone knows that I have a potential conflict of interest. Read my review with that in mind. I’m trying to be unbiased, and I have no direct financial or editorial interest in HTML5 Unleashed, but I am the author of a book in the same series. So, now that that is out of the way, let’s dig in.

HTML5 Unleashed is filled with beautiful, full color pages. Figures and code appear just as they do in browsers and quality code editors. That is a really nice bonus that makes long code samples (and we all love long code samples!) easier to read and gives us an easy way to visually confirm that what that code is supposed to do is being done in our browser when we try it out. Seriously, there is color on every page. I like it.

The book starts with a nice, easy introduction that gives us some historic and technical context as to why HTML5 was created and what it is designed to do. For those of us who have been making webpages since the early GeoCities era, it is a nice refresher that makes for a very quick read and provides an accurate context for the newcomer.

Chapter 2 is another quick introduction chapter that presents the important concepts for HTML5 from a high-level. This is actually important as it clarifies the “why are these things being presented” well before you dig in to the meat of the book. Don’t skip it, it’s short and worth reading.

The rest of the book, chapters 3-13, cover what I consider the main reason for buying the book. In here are the details we all want. While a quick Google search will give you most of this information, maybe all of it, it will not give it to you in such a well-planned order that builds upon itself.

Specifically, topics include everything from the basics like Doctypes and semantic tags to forms. Then, we move into deeper topics like rich media. A set of four chapters is dedicated to covering HTML5 canvas, which is the flashiest and most immediately-gratifying part of the new specification as it “natively enables interactive movies, games, charts, diagrams, and tons of other forms of dynamic visual content.” The canvas section includes topics like when and when not to use canvas over other options, working in 2D and even in 3D, making canvas interactive and stateful, performance tips, and even a discussion of its expected future.

The last section of the book takes a 5 chapter romp into HTML5′s JavaScript APIs. There was a time when JavaScript was optional for the web, but if you want to make anything relevant today, you must know how to use at least some set of JavaScript functions. Here, the book covers everything from Geolocation to storage options to messaging and web workers. It goes even deeper into network communication using WebSockets and XMLHttpRequest Level 2. Finally, it covers microdata and related small things and gives you a heads up toward topics you may want to explore beyond HTML5.

This book does not cover presentation, such as is done using CSS. This is the content side of the equation, and honestly it is the part I enjoy most. However, it will not help you learn everything you will need to know about web programming and site creation. It will, however give you the useful tools you need to upgrade your skills to today, if you are an HTML4 or XHTML proficient, and it will help the novice gain a solid foundation and understanding of what makes a site work, which I think is important before you start to work on making it beautiful.

Disclosure: I was given my copy of this book by the publisher as a review copy. See also: Are All Book Reviews Positive?

Survive! Inside the Human Body

This is a special review. This time around, I am including three books in a new educational manga series. I originally intended to produce three individual reviews, but I’m pretty excited about these books and don’t want to make you wait. The series was just published, so if it isn’t on your local bookstore shelves now, it will be soon.

Survive: Inside the Human Body, Volume 1: The Digestive System, Volume 2: The Circulatory System, and Volume 3: The Nervous System are being published by No Starch Press, the same people who brought us the Manga Guide to series, several books from which I have reviewed here in the past. Like that series, this set of books was originally published in another country (Korea, this time) and licensed by No Starch and translated into English. During this process, the information in these books was reviewed by medical doctors for accuracy. The story line was also updated in a few places to adjust the fun to an English-speaking audience.

There is much to love in this series. The information is useful and detailed. I’ll tell you more about that in a paragraph dedicated to each volume. In all the volumes, the illustrations are beautifully done, colorful (not black and white!), and genuinely add to the experience without distracting from the information or the story line. There are lovely samples to view on the No Starch site at the links above.

The three volumes have one story line that arcs across the set. It is a cute story that is pretty typical in its use of standard manga motifs like overstated graphic representations of emotions. In all three volumes, at the end of each chapter, there are a couple of pages that step out of the arcing story line that give more academic details with just enough detail to tie up any loose ends that the reader may have without crossing the line into overwhelming the reader.

The first volume covers the digestive system. It covers everything from the mouth to the anus and all the stuff in between. Beautiful illustrations show useful details and help the reader understand what the action describes. We learn about how food is processed, how nutrients are absorbed, how beneficial gut flora are vital to the process, and how waste is eliminated.

The second volume covers the circulatory system. Here we learn about blood and its components, the liver and filtration, the heart, the lungs and oxygenation, the bones and blood creation, blood types, and we even get a few bonuses with side tracks into skin, the nose, and the ears.

The third volume centers on the nervous system. Topics covered include the brain, different kinds of cells in the nervous system, and the diagnostic tests that can be used by doctors to investigate when problems occur.

Disclosure: I was given my copy of this book by the publisher as a review copy. See also: Are All Book Reviews Positive?

Diabetes and Me

I don’t have diabetes. However, I know people who do. I also know people who are at risk. Some of these are kids. This book will be useful to anyone who has diabetes or is close to someone who does, especially if a child, adolescent, or teenager is involved.

Diabetes and me: An Essential Guide for Kids and Parents is filled with excellent information and advice that make the book worth reading accompanied by hand-drawn illustrations that transform the information into a comic book format that is a bit more accessible for both younger and older readers. It does so with a tone that is positive and hopeful about the future. The author, Kim Chaloner, is a middle school science teacher who was diagnosed with diabetes at age sixteen. Her husband and the book’s illustrator, Nick Bertozzi, is an award-winning and established illustrator and author in his own right.

The book acknowledges from the beginning that a diagnosis of diabetes is a life-changing event. It is with this perspective that the author gently takes the reader on a journey through the maze of fear, uncertainty, and confusion that is common and normal in such a moment and beyond all this to help the reader figure out how to answer the question, “What do I do now?”

The book is filled with practical information about doctors and specialists and what each one the diabetes patient is likely to interact with and why. It discusses common treatment options, monitoring, diet, and exercise. The book acknowledges various doctors and treatment centers for their assistance vetting and guiding the content and gives a solid warning to the newly diagnosed to be careful about what sources of information they trust, especially when it comes to internet searches and potential snake oil treatments.

As someone with no personal experience with diabetes, I learned a lot. I can easily imagine that someone struggling with a new diagnosis would find the book a welcome resource, as well as someone who has had diabetes for years but doesn’t feel like they really understand what is going on.

Disclosure: I was given my copy of this book by the publisher as a review copy. See also: Are All Book Reviews Positive?

Computers as Theatre Second Edition

Back in high school, a very long time ago, I took a drama class. I also took a one-sememster drama class at the university. This means I have a very elementary foundation, but I am far from an expert in the field. However, from the moment I heard this book’s title I immediately saw the potential.

Computers as Theatre, Second Edition is an update to a 20-year-old classic in the field of human-computer interaction. The author, Brenda Laurel, is an Adjunct Professor of Computer Science and Affiliated Faculty for Games and Playable Media at the University of California, Santa Cruz. In addition to her academic credentials, which include a PhD in theatre, she also has serious real-world experience with previous employers like Atari, Activision, and Apple.

The book is based on the simple premise that effective interface design, just like effective drama, must engage the user directly in an experience involving both thought and action. Laurel’s key point is that a user’s enjoyment must be a paramount design consideration, and she posits that it demands a deep awareness of dramatic theory and technique. While I might shrink back from the idea that this awareness is an absolute requirement, I will quickly and easily concede that this awareness would be extremely useful.

This is not a book of practical tips and tricks. It is a reader-accessible study that lays out the philosophical and academic foundations for understanding first how humans audience members interact with drama and uses that as a basis for thinking about how computer users can more effectively be enabled to interact with computers.

The beginning of Computers as Theatre focuses on both classical and modern schools of thought and theory about drama. This is very interesting and outside of my previous experience. It got me thinking about things I had never considered. I like that.

The rest of the book takes this knowledge and applies it to computers. It does so in ways that alternately seem obvious and revolutionary. I will illustrate using one small portion of the book’s content.

In drama, the action is represented as a whole and created by the playwright and director to be the same in every performance. In human-computer interaction, the action is collaboratively shaped by both the designer and the person using the computer; it is a joint-venture and may change with each interactive session. And yet, in both instances, there is an expected beginning, middle, and end. The audience expects to move from a beginning point to an end point with a purpose. The characters in a drama exist and act to move this plot forward. So do the elements of a computer interface design.

Have you have ever sat at a computer looking at a piece of software and wondering “What’s the point?” Then you have experienced a bad interface design. Learning how to create an interface that has an obvious point and reason behind each of its constituent parts and actions is one of the things this book intends to teach, but again, from a philosophical rather than practical standpoint. Here we do not learn the “what to do” answers so much as the questions to ask. In the long term, this is usually more valuable regardless of the topic or field.

Disclosure: I was given my copy of this book by the publisher as a review copy. See also: Are All Book Reviews Positive?

The Cartoon Introduction to Statistics

The is the second statistics-cartoon/manga mashup book that I have reviewed. The first one was about four years ago. Both books are pretty good, but they each present the topic differently. The previous book tells one main story as the book progresses, and statistics is taught because this story exists. It contextualizes the academic topic while expressing it in a simpler way and then adds the complex mathematics at the end of each chapter of the story that fit that chapter’s needs.

The Cartoon Introduction to Statistics teaches the basics of statistics using comics to illustrate various portions of the greater topic. Each chapter in the book covers a very specific facet of statistics, and each of these chapters build upon those that came before it. We start with a nice introduction that gives a high level view of what statistics can do for us and why we should care. This leads into discussions of numbers, random raw data, sorting, sample size, variables, simple and complex analyses, generalizing from a sample to a wider population, parameters and the central limit theorem, normal distributions, probabilities, inference, confidence, hypotheses and testing, and what statistics can and can not tell us (probability vs. certainty). All of the mathematics are contained in the back of the book and are referred to in the text when and where appropriate.

What makes this book stand out are the illustrated examples used throughout the book. Rather than being a book with one main narrative or plot, this is a non-fiction prose book that has occasional illustrated stories used to clarify complex concepts. Some are simple, like talking about how to determine how many fish in a lake fit a certain category. Others are more imaginative, like exploring whether male or female dragon riders are faster while taking into account dragon size. Regardless of whether the examples are more realistic or more whimsical, they are well thought out and useful. The illustrations throughout the book are nicely drawn and consistently appropriate.

I’m sure the question out there is whether I like this book better or the first one I reviewed. The honest answer is that I think both books are very well done, but each will appeal to a different audience within the population of people struggling to grasp the main concepts of statistics. Some, especially the math-phobic, will find this book more useful with its authors’ decision to move the mathematics to the back of the book and concentrate on the bigger picture and its parts. Others will appreciate the similar progression of topics of the other book, which puts the math at the end of the chapter and immediately reinforces what was just taught. Both are worthy entries in the education-focused manga/comic library.

Disclosure: I was given my copy of this book by the publisher as a review copy. See also: Are All Book Reviews Positive?

Legends of the Blues

Computers are not the only thing I am interested in. Not by a long shot. I have so many interests and hobbies that I haven’t yet mentioned on this blog. One of my interests is music. Some of you know I am a musician. I play bass in a local band. I have played guitar for more than 20 years. I love music. One style of music that has been a strong influence is the blues. Not only modern stuff like post-British-Invasion bands, but the old stuff, too. I also enjoy comics and manga and I’ve reviewed several titles that combine these with educational topics.

Legends of the Blues is filled with 100 one page biographies of blues musicians. The artists in the book were chosen by the author, William Stout, because he both loves their music and because he thought it would be fun to draw a picture of each of them. And draw he does! Stout calls on the style of R. Crumb as he creates beautiful portraits of each artist. Part of the process of selecting artists was that Stout had seen an older book by Abrams titled R. Crumb’s Heroes of Blues, Jass & Country. Stout tried not to repeat any of the artists from Crumb’s book, but in the end there were a couple he loved too much to leave out of his own book.

So, to the point. Who is in here? There are tons of big names you should recognize like Bessie Smith, Lightnin’ Hopkins, and Blind Willie Johnson. There are also some less-well-known artists who music really deserves to be better known, people like Cow Cow Davenport and Big Joe Williams.

Each biography in the book lists the artist’s main instruments, when and where they were born and died, and some recommended tracks along with a one page synopsis of their place in the history of the blues. Each one is interesting and worth reading. Then, on the facing page, you have a beautiful portrait of the artist being discussed. Very cool.

That would be enough for me to give this book a recommendation.

There is a bonus that I did not expect and appreciate greatly. Accompanying the book is a CD of 14 songs chosen by William Stout. The CD is titled “Saturday Night and Sunday Morning” and is an eclectic mix of traditional blues from both the juke joint and the Gospel sides. This CD includes several songs I have not heard before and did not have in my library, but which will be in regular rotation in my play lists from now on.

If you like blues, this book is worth the price of admission.

Disclosure: I was given my copy of this book by the publisher as a review copy. See also: Are All Book Reviews Positive?