This is a guide for students new to the course forum Ed. It’ll cover how to effectively ask questions and how to efficiently search for what you want. This guide is meant for people who are famililar with Piazza and we’ll make several references and comparisons.
At a high level, Ed is a high-tech version of Piazza with some elements from StackOverflow. For those who are unfamiliar, StackOverflow is a public forum where people ask questions related to programming and software engineering. Full time software engineers use this all the time to get quick and reliable answers, so you should feel free to as well! Check out this link for an example question posted to StackOverflow. Now let’s get into Ed.
After reading this guide, you should feel familiar with Ed and able to make the most out of it. Let’s get into Ed specifics.
Landing Page #
When you first visit Ed, you’ll see that it looks similar to Piazza. All important announcements and index posts will be pinned so that you don’t need to spend too much time looking for them. That little blue dot on the left side of the post means that you haven’t viewed that post, so if you see that next to a pinned post you should definitely read it thoroughly. Here is what the landing page of CS 61BL looks like (the summer version of the course).
We’ll get into categories later, but think of them like tags from Piazza. Tags/categories are a way to organize your posts so that they’re super easy to search for later.
Remember that Ed is the primary point of contact between us, so make sure you read it every day, and pay special attention to it during and around due dates in the case that any deadlines change or we have any important announcements.
Next you’ll see a few recent posts, again, similar to Piazza. Now dive into the specifics of how Ed works, starting with Questions.
You can create a question or note (called a “post” on Ed) by clicking the big blue ‘New Thread’ button in the top left corner and then selecting what you want to create.
Here is what an unanswered question on Ed looks like:
You’ll see that Omar has posted a question that he wants us to answer. Just like in Piazza, instructors and TAs can endorse questions as well as student answers. Only TAs and instructor’s can endorse, so you can have more confidence that the answer is correct on this one. If you see an endorsed question, you may want to check it out as it may be particularly insightful!
In Ed, there is more distinction between follow-ups under a thread. If I had a clarification on the question, I can comment on the question. This is not answering the question, so instructors and TAs will still see the question as unanswered. You can see that Allyson has asked for the worksheet Omar’s question is from.
You can see that Akshit has answered Omar’s question and has even gotten his answer endorsed, liked, and has a green check mark. We’ve already talked about endorsement, it just means that an instructor or TA has verified this answer is trustworthy. Everyone can like a post, comment, or an answer, both students and staff. You can think of likes as +1s or a thank you!
The green checkmark is something that only one answer can receive on a post, so it will be given to the best answer on the post. When a staff member answers a question, it is automatically marked with a green checkmark. You can see that Sara’s answer appears lower on the page since the asker thought Akshit’s was better. This is similar to what you’d see on StackOverflow.
If you post a question on Ed, and get an answer from one of your fellow students, be sure to mark it with the green checkmark! Some student answers are just as good as ours, so if you’re happy with the answer it can save us some time.
Follow-ups and Comments #
You can also create a follow-up on an answer in a hierarchical form, something that Piazza doesn’t support. With these hierarchical comments, it is much easier to track what’s going on and answer individual follow-up questions. You can see that Omar has asked a follow-up question on Akshit’s answer.
You can use “Reply” to follow up with a nested, hierarchical comment, or “Comment” to start a different comment chain.
Summary of Icons #
Here is a reference table if you get confused.
|Given to just one answer on a Question, usually the best answer.|
|Only given by a TA or instructor that thinks the post/answer is trustworthy.|
|Given by students or staff, not significant of anything but makes you feel better.|
|Sets this post to be watched by you. You’ll receive email updates on any activity on this post.|
|Stars this post on your account. Allows you to use a filter to see your starred post for quick access. You might consider starring helpful posts so you can easily and quickly find them.|
Creating an Ed question #
Now that we’ve talked about how to “read” an Ed post, we’ll talk about how to write one.
Categories are like tags from Piazza and help the forum stay organized. By adding a category to your post, you are helping TAs find your post and answer it quicker, and also helping other students find your post and learn from the answers.
The first thing you’ll do when you create a post is to select the right category for it and, if applicable, the right subcategory and subsubcategory. Categories are just like tags from Piazza, and you’ll see why they’re so useful after reading about search below.
Here is an example where I will ask a question about Pset (problem set) 2:
To view only posts in a specific category, subcategory, or subsubcategory, click on the category in the left sidebar.
Meta Options #
Like in Piazza, you’ll have some options under your post if you want to ask anonymously or make your question private where all staff members can see. Feel free to ask anonymously. We do discourage asking private questions, as collective knowledge is helpful, but won’t stop you.
Formatting Options #
If you’re really into Piazza, you’ve probably taken advantage of the generous formatting options on Piazza. This includes adding pictures, using markdown, using LaTeX, and more traditional formatting like bolding/underlining. This makes the question much nicer to read, which makes it more obvious and clear what you are trying to ask. Here is the bar where all the formatting options are located:
And here is a table describing how to use each formatting option.
|Select this to get a drop-down menu of different text types, including code. There isn’t an explicit markdown option, just use the backticks ` as you normally would.|
|These are your typical bold, italics, and underline options.|
|This is a shortcut to the code text type. Instead of using this, you should use the interactive code block.|
|You can use this to hyperlink text in your post. Highlight the word or words you want to hyperlink, click this button, and paste the link.|
|Bulleted lists and numbered lists.|
|Inserts an image into the post.|
|Embeds a video, you shouldn’t ever have to do this.|
|Attaches a file to the post. You shouldn’t ever have to do this.|
|Click this to insert LaTeX formatted math into your post. Unfortunately, this will create its own line unlike Piazza LaTeX options. Luckily, if you know LaTeX, you can just insert your single $ signs and go for it. If you don’t, it’s really simple to learn since the only thing you’ll ever do in LaTeX is easy asymptotics stuff. You can learn this within 20 minutes.|
|Insert an interactive code block. Nicer than the normal code block since this has better syntax highlighting and things like automatic curly brace insertions, which is nice for Java. The language (on the right side) should be set to Java by default, but if it isn’t go ahead and change it. You’ll see 2 checkboxes for “Line Numbers” and “Runnable”. There isn’t any reason to not have line numbers, so keep those on. The runnable option allows us to run your code, but unfortunately it really doesn’t work well with Java (you need to define a class with
|Not useful for this class. Allows you to display basic website stuff.|
|You can draw things with this.|
|Used to preview your post to make sure all your fancy elements render properly.|
In the following example, you can see that Omar has asked a question about a specific problem from a specific Problem Set and has categorized it properly. Now, in the future, if another student is going through Pset 2 and has some questions they can simply use the filter to see questions in that subcategory and not have to ask duplicate questions.
Remember how we said Ed search was great? Let’s go over how to use all the search features as well as good search strategies.
Here is what the results look like for a good search:
Let’s go over how to use all the search features as well as good search strategies:
Using Keywords #
This is the red (top-left) box on the image above. Ed search is a lot like Google search. If you had a general question on how to do recursive runtime analysis, you could search “How do I calculate runtime on recursive functions?”. Instead, you could also search for the key words in this well formatted question, so something like “recursive runtime analysis”, which would give you even better results. When you write a well formatted question like before, Google actually extracts the keywords for you. While we can’t write natural language questions into Ed, given the right keywords it does a very good job. Ed is able to search not only for post/question titles, but also down to sub comments level. As you type a new post title, it will also show you related posts according to what you type. Make sure to check them out, as a question you have in mind may have already been posed!
These next two features will definitely help you search, but often times the right key words will make the right post jump to the top of the results.
Search Filters #
This is the green (top-right) box on the image above.
If you’re looking for a question with an answer you can trust, you might want to filter for only endorsed posts. This will limit your search to only posts that have been endorsed by staff. Similarly, if you are a helpful student and like to answer other student’s questions, you can search for unanswered or unresolved questions and help them. Thanks in advance!
Search Categories #
This is the purple (center-right) box on the image above.
Like previously mentioned, you can limit your search to just posts in particular categories. So if there was an inheritance question on midterm 1 that you had questions about you can filter your search to posts with that subcategory.
Search Date Ranges #
This is the blue (lower-right) box on the image above.
You can also specify a range of dates that you want to search for. Less useful, but it exists if you need it.
The guide is good for letting you know what things Ed offers, but the best way to learn it is to just use the thing! You’ll find it very similar to Piazza with a modern twist on it. Remember to keep up the Ed ettiquete so that all students can benefit from the wonderful questions you all ask :)
Ed has some official resources that are subsets of what’s covered in this page: