WTF ... IS WTF!?
We are a collective of people who believe in freedom of speech, the rights of individuals, and free pancakes! We share our lives, struggles, frustrations, successes, joys, and prescribe to our own special brand of humor and insanity. If you are looking for a great place to hang out, make new friends, find new nemeses, and just be yourself, is your new home.

If you're gonna be writing a manual, do it properly.


Raging Hermaphrodite
Right now, I am doing an electrical circuits course (go figure for software engineering...) which is basically the mental equivalent of Vietnam and Bosnia together, with a bit of Kosovo thrown in as an en-cas. With such an amount of raw pain coming up, you can be sure there'll be diarrhea.

I am currently working with a 2004 edition of the course manual.

It's handwritten.

Sorry man, but those types of things weren't even done in the 80s. WE USE TYPED AND PRINTED MANUALS. ALWAYS ALWAYS ALWAYS. Even my college philosophy teacher, who claimed to know shit-all about computers, was able to write a manual of his own. So why can't a university teacher with several doctorates in his hand do it? I almost understand him, as he once sent us a freshly revised lab assignment in PDF format.

Waddya know, it was corrupted.

Oh, and half the students didn't get it. By chance that the copy on the school's web site was working.

The manual is also impossibly cryptic. You know there's a problem when you realize that the exercise book is bigger than the manual.

Here, just tonight, I was trying to find out how to calculate the phase shift out of an equation of frequency. For those non-electrical students here, I'll briefly explain: This equation allows us to figure out the amplification of an electrical signal for any frequency - each circuit has its own equation for that. Either way, I needed the phase shift.

This is what I found in the manual:

"For a certain frequency, there is a certain amplification (or attenuation) and a certain phase."

That's it. There was no more. I had to google my answer up, and go into what I could qualify to be the bayou of the Internet to find out the way to calculate the phase shift. Bra-fucking-vo. The Internet is a better teacher than the teacher himself.

Wannabe teachers, take this as an example. You're gonna be writing a manual? Make it on the computer, with many examples, with computer-drawn diagrams and pictures, and find a better way to hold it together than by using cheap-ass plastic coils. Oh, and make sure it's at least decently understandable and that we'll know where to find what we're looking for. Puh-lease.

My apologies to any of you who were planning to go to university. Looks like I've mistakenly hit you with some cold, hard truth. You thought college and high school sucked? HA, I say!