Monday, June 01, 2009

See figure 1

One of the first lessons you learn in grad school is that your text book(s) is/are as valuable as a paperweight. At least in the hard sciences, the field tends to move fast enough that, by the time a text book is published, the information within is either incomplete or inaccurate. Consequently, you'll spend more time reading the relevant journals for your field than any text book, and new information is introduced through review articles.

The long preface is only to introduce Shamus's post on the problems he encounters in the tech world, writing support documents and other technical documentation. Though many of his examples are angled towards programming or coding languages, the general principles are by no means unique to his field.

I find often that the scientific literature suffers from the problems Shamus describes: No explanation of technical terms, assuming a higher level of knowledge on the part of readers than is warranted, assuming a high level of knowledge in related (or not) fields, over-complicated examples, building too steep a learning curve, and so on. One problem that is more unique to this field is the use of self-serving examples. That is, all of the "relevant" work referenced by the author of a review is to his (or their) own work in the field. While this might be appropriate if you're one of a handful of people who actually study the topic at hand, it usually gives only a narrow impression of the work being done in the field, and thus not appropriate for a "review."

One idea that Shamus introduced that I would love to see implemented more fully in the scientific journals is better use of the electronic medium. Everything that is published on paper also is published online as a PDF. Journals like Science usually affix a "title" page to it, with links to the supplemental material on the web (additional figures, movies, and whatever else the authors considered important enough to include but not critical enough to warrant space in the paper). However, taking this further would be an incredible step in bringing science into the age of the internet.

In a review article, what if certain terms or phrases were hyperlinks to either a "dictionary" of terms or to futher review articles on the specific topic? What if the citations at the end of the paper were themselves hyperlinks which would take you to the reference? What if each of the authors' names were hyperlinks to other articles they have published? When a technique is not fully explained by said to be done "as previously described," either link to where it was described or to a database which explains the principles such techniques.

While I realize this might seem like a lot of work to put into a simple PDF journal article, this would be insanely useful to all sorts of people. And these are just the hasty suggestions of a graduate student . . . I'd love to see what sorts of suggestions actual experts might come up with.

4 comments:

Dr. Church said...

I couldn't agree more. I have long felt that scientists and engineers would benefit greatly from further reflection on this simple question: To whom am I writing/presenting this material? Having a basic understanding of your audience is Communication 101. And yet I can't count the number of academic seminars I have witnessed in which I was lost within minutes. Is this because I lack the brain power to understand the subject matter on display? Certainly not! I'm a rocket scientist! (or so I let people call me) The problem is that the presenter spent no time whatsoever considering the fact that his audience knows nothing about quantum-hydro-spectra-dento-mamma-genation. I suppose I am particularly sensitive to presentation technique and style on account of my background in theatre, but I don't think one need be a thespian to give an articulate, accessible presentation (or publication) without sacrificing rigor and scientific merit. On the contrary, the merit of the work may be enhanced in direct proportion to its comprehension.

Furthermore, I agree regarding publications online. For that matter I am surprised by how much I miss the free journal subscriptions provided by the University. Now whenever I want an article I'm expected to pay 39.99 for the issue of the journal? Bollocks! I will say that in the pdf of my own dissertation, the hyperlinks of which you speak did in fact exist. In the text when it said "see Fig. 2" you could click on the link to jump to figure 2. Likewise for equations and for references, etc. etc.

Hal said...

Can you just imagine a world where scientific literature had the accessibility and ease of navigation of Wikipedia? It would revolutionize the field.

Barry G. said...

I'm not sure if a completely democratic approach is appropriate in the literatures of hard science.

Unless maybe you had to take a "knowledge of the field" test before being granted the ability to alter the "science."

Jorge said...

"I'd love to see what sorts of suggestions actual experts might come up with."

I suspect most of the (now jaded) actual experts would just say "See figure 1".