Navigating This Website

Steven Zeil

Last modified: Dec 02, 2014

Contents:
1. The Directory Pages
2. Common Navigation Buttons
3. Asking Questions and Getting Answers
3.1 Public and Private Communications
3.2 Etiquette in Email and the Forum
3.3 Automatic Notification of Announcements & Forum Posts
4. Asking Good Questions
4.1 Identification
4.2 Thou Shalt Not Paraphrase
4.3 If I Ask You a Question, Answer It

This course website contains many hundreds of web pages. It can be a bit daunting when you are starting out. This document explains the basic organization of the site.

1. The Directory Pages

When you first enter the course site, you are taken to one of several directory pages, easily recognized by the row of buttons down the left side. The directory pages serve as gateways to the various documents that make up this web site.

This may not be an exhaustive list of the directory pages. Feel free to poke around the directory, getting yourself familiar with the overall structure of the website.

2. Common Navigation Buttons

At the bottom of nearly every page you will find these buttons:

 home This takes you back to the Outline/Topics page.

 bb This takes you to the course BlackBoard site.

 forum This takes you to the course Forums, a place for open questions and discussions related to the course material.

 email This opens up a window from which you can send email to the instructor about the web page you have just been reading.

You can, of course, send email to the instructor at any time via your “normal” email program, but this button primes the message with the name of the course and the URL and title of the page on which you clicked that button. If you prefer to initiate email by other means, make sure that you include CS330 in the subject line and the URL of the relevant page in the body.

Document Formats

To the right of the buttons described above, you may see one or more of the following. Each of these takes you to a different format or version of the document that you have been viewing.

 singlePage The document that you are viewing, formatted as a single HTML-page.

 slidy The document that you are viewing, formatted as slides for presentation by an instructor during a lecture.

 ebook The document that you are viewing can be found within an e-book (epub or mobi format) that colelcts together most of the course documents into a single package that an be read even when off-line.

3. Asking Questions and Getting Answers

As already noted, your options for communicating with the instructor include email and course forums. You also have the option, of course, of meeting with the instructor during office hours, as described further in the syllabus. It’s likely, however, that in many cases you won’t want to wait until the next block of office hours rolls around that coincides with your own free time. Email and the forums provide a way to possibly get quicker answers to any questions that you might have.

3.1 Public and Private Communications

When you create a thread within the course Forum, you are opening up a discussion that can be read by everyone enrolled in the course.

In general, any conversation in which you discuss all or part of your solution to an assignment, even if you are only speculating on possible solutions, should be not be conduced in public forums.

Use email or office hours instead for those kinds of questions.

On the other hand, questions about the course subject matter or purely clarification questions about an assignment may be useful subjects for the entire class. These are good subjects for the Forum. The instructor may, if he feels it is appropriate, copy your e-mailed question to the Forum so that the answer becomes available to everyone.

3.2 Etiquette in Email and the Forum

3.3 Automatic Notification of Announcements & Forum Posts

When you enter any of the course Forums in Blackboard, there is a “Subscribe” button available. Clicking on that will ask Blackboard to send you email whenever someone posts in the Forum.

4. Asking Good Questions

Whether posted in a Forum or sent via email, a question is the beginning of a dialog. A well-prepared question will get you an informative answer quickly. A poorly-prepared one may get you irrelevant answers or may require several rounds of back-and-forth dialog, delaying your eventual answer by many hours or even days. So it’s in your own self-interest to ask your question in a way that gets you the answer you need as quickly as possible.

4.1 Identification

Who are you? : If you are sending me email, make sure your course login name or your real name appears somewhere in the message. I hate getting mail from partyAnimal@hotmail.com saying “Why did I get such a low grade on question 5?” when I have no idea who this person is!

What course is this? : Again, if you are sending me a question via email, please remember to state which course you are asking about. I teach multiple courses most semesters, and having to go look up your name to see which of my courses you are talking about is annoying. In fact, it’s a good idea to make the course number part of the subject line.

Use a clear and precise subject header.: In the Forum, your subject header helps people decide if your post is worth reading. It also helps people find prior discussions that may have been relevant to later posts.

4.2 Thou Shalt Not Paraphrase

There’s nothing more frustrating than getting a question like

“When I try to compile my solution to the first assignment, I get an error message. What’s wrong?”

Grrr. What was the (exact) text of the error message? Was this on a Linux or Windows machine? What compiler were you using? What compiler options did you set? What did the code look like that was flagged by the message?

No, I’m not kidding. I get messages like this all the time. And it wastes my time as a question answerer to have to prompt for all the necessary information. It also means a significant delay to the student in getting an answer, because we have to go through multiple exchanges of messages before I even understand the question.

The single most important thing you can do to speed answers to your questions is to be specific. I’m not psychic. I can only respond to the information you provide to me.

All of the above are real quotes. And they are not at all rare.

The problem with all of these is that they omit the details that would let me diagnose the problem.

And it’s not all that hard to provide that info. Error messages can be copied and pasted into your message. The commands you typed and the responses you received can be copied-and-pasted from your ssh/xterm session into your message. Your source code can be copied-and-pasted or attached to the message.

Note that this information is almost always plain text. Unless you really need to show me graphics, please avoid screen shots. They are often hard to read and often do not allow me to make the fine distinctions I need to tell what is going on. Keep in mind that raster graphics formats (gif, jpg, png, etc.) often look very different when rendered on screens with different resolutions.

4.3 If I Ask You a Question, Answer It

I often respond to a student’s question with further questions of my own.

Teachers since Socrates have always done this, and students have always been annoyed at it. But who are we to argue with history?

Sometimes I do this to get more info I need, sometimes to guide the student towards an answer I think they should be able to find for themselves.

It’s surprising how often students ignore my questions and either never respond at all, respond as if my questions were rhetorical, or, if I have asked 2 or 3 questions, pick the one that’s easiest to answer and ignore the rest.

This pretty much guarantees that the dialog will grind to a halt as I wind up repeating myself, asking the same questions as before, and some students go right on ignoring my questions, …