Ed Policies and Guidelines

介绍

咱们用 Ed Discussions 这个平台作为课程论坛。如果你是第一次用 Ed，可以看看Ed 指南，帮你快速上手。这篇文章里有一些关于在 Ed 上发帖的注意事项，希望大家仔细阅读，保证这学期都有个良好的交流环境！

保持 Ed 的包容性

在 Ed 这样的公共论坛里，任何针对、排斥、不尊重或歧视他人的内容都会被删除，发布者也会受到相应处理。请尽量营造一个对大家都友好的环境。如果你觉得受到了其他同学或者课程 staff 的攻击、排斥或者歧视，请填写事件报告表进行举报。如果你不想和 staff 沟通，也可以直接向学校相关部门反映情况 (https://diversity.berkeley.edu/report-incident)。

总体要求

咱们不想一开始就列一堆“禁止事项”，但是请大家不要：

不要发没用的回复：像 "+1" 和 "我也是" 这种回复没有任何意义，还会给关注帖子的人发一堆没用的邮件。这种回复可能会被删掉。想表达支持或者感谢，可以用帖子旁边的点赞按钮。

标题别太夸张：比如全大写或者用一堆标点符号，这样只会让人觉得很烦。标题（包括内容）尽量描述清楚，专业一点。

不要发和课程无关的内容，或者散布谣言：Ed 上只允许讨论和课程相关的内容。发一些猜测性的、煽动性的或者故意误导人的东西会影响 staff 和其他同学的交流。

如果你自己解决了问题，不要只说一句“没事了”或者“已修复”：论坛是大家一起学习的地方。你解决了问题，也应该把解决方法分享出来。最烦的就是那种提问之后，自己解决了就回一句 "没事了，我搞定了！"，或者干脆啥也不说。这样其他遇到同样问题的人就没法学习了。所以，记得把你的解决方法写在回复里！

为什么要使用论坛？

杜克大学、北卡州立大学、北卡大学和佛罗里达大学最近的研究表明，如果学生在论坛（比如 Piazza 和 Ed）上提一些有建设性的问题，并且能展示出自己的思考过程，或者尝试解决问题的过程，对学习的帮助是最大的。通过提问和思考，同学们可以锻炼元认知能力，也就是思考如何学习和解决问题的能力。

Office hour 和 lab 不一定随时都有，而且也不一定能马上联系到 TA。所以，你可以在 Ed 上提问，然后先忙别的，等有了回复再回来看。

而且，论坛这种异步交流的方式在实际工作中也很常见，比如 StackOverflow 和公司内部的 issue tracking 系统。

CS 61B 论坛使用规范

论坛好不好用，关键在于大家是不是都能好好利用它，一起维护论坛的质量。

分类

CS 61B 人很多，帖子肯定也少不了。为了方便大家查找信息，咱们会用到 Ed 分类。在 Ed 上发帖或者提问，一定要选对类别。

各类别的概述如下：

Logistics（课程安排）：关于课程安排的常见问题。

Lectures（讲座）：关于讲座内容的问题。这个类别里有个模板，记得填写讲座的编号。

Projects, Labs, Homeworks（项目、实验、作业）：关于作业的问题，或者需要 debug 帮助的帖子都发这里。每个作业都有对应的子类别。子类别下面还有更细的分类，比如私人 debug 问题 (Gitbugs) 和公开问题。举个例子：Projects - Project 1 - Gitbugs 和 Projects - Project 1 - Conceptual (Circular Buffer)。

Discussions（讨论）：关于 discussion worksheets 的问题或者概念上的疑问。每周的 discussion 都有单独的子类别。 考试 : 提问关于考试安排、历年真题以及其他任何与考试相关的问题。 临近考试时，我们会增加额外的分类，方便大家提问关于往年考试的问题。

其他 : 如果有任何不属于以上类别的课程相关问题，都可以在这里提问。

社交 : 想找人一起组队学习或者开学习小组吗？来这里发帖吧！

外部公告 : 所有来自与CS 61B无关的外部组织的帖子都会发布在这个版块。 这些帖子需要经过课程 staff 的审核才能发布。

如何提问，以及如何不提问

比较遗憾的是，在 Ed 上提问可能回复会比较慢，因为我们没法一直盯着论坛。 在寻求帮助之前，你应该尝试自己回答你的问题！ 我们也希望大家能学会自己解决问题，虽然有时候可能比直接问 staff 慢，但从长远来看肯定更有帮助。 以下是一些可以帮助你的资源：

Ed 上之前的提问: 善用 Ed 的搜索功能，可以在各个版块里搜索，不用把所有帖子都翻一遍。

官方课程资料: 作业指导书是很好的参考资料。 另外，每个作业的页面顶部都会有 FAQ 链接。 FAQ 会随着作业的进行不断更新，记得常回来看看！ 课程 staff 也会根据大家遇到的问题，补充一些额外的资料。

Google 或者你常用的搜索引擎。: 也许你会觉得用 Google 搜索好像不算“独立编程”，但实际上，专业的程序员也经常上网搜索类似问题的解决方案。 现在学会高效搜索，对你这学期乃至以后的职业生涯都大有裨益。 注意：不要直接搜索答案代码！

但是，你不应该在同一个问题上花费数小时，而应该寻求帮助，可能是在论坛上。 当你在 Ed 上寻求帮助时，你可以做以下几件事来确保你收到的回复更有可能解决你的问题。

清楚地描述你的问题，以及你觉得什么样的帮助能让你继续。 助教们又不是神仙，我们不可能猜到你哪里卡住了，或者你想问什么。

如果你的问题没有包含足够的信息让我们能够回答，或者没有向我们展示你到目前为止尝试过的内容，我们会询问。 你会得到一个总体上较慢的答案，但你也会学到如何改进你未来的问题以获得更快的回复。

同样，你应该不要做以下一些事情来获得回复：

问“给个提示”或者“直接给答案”: 我们不知道你想要哪种提示，也不知道你想做什么。 我们甚至不清楚你有没有自己尝试过，还是说一看到报错就来问了。

我们不会给出答案，而是会提出后续问题来澄清你所要求的内容。

说“我什么都不懂”: 而是应该试着找到你卡住的地方。 如果你完全没有头绪，那也可以提问——但这和“我啥都不懂”可不一样。

这里的一些材料摘自 Adam Blank 关于 ["如何寻求帮助"](https://countablethoughts.com/documents/HowToAskForHelp.pdf) 的指南。

概念性帖子

通常，你会对实验室或项目中的概念性想法，或讨论、过去的考试或外部资源中的问题有疑问。 以下是你应该遵循的一些指导方针，以便更快地获得有用的答案：

不要问你的解决方案“是否正确”: 要我们帮你理清思路是很费劲的，所以不如直接告诉我们你的想法，这样我们才能更好地帮你，也能避免一些不必要的误解。

私人调试帮助，或 Gitbugs

有时，你可能会遇到需要向课程工作人员展示你的代码的问题。 但是，根据我们的 [协作政策]， 你不得公开发布代码，包括在公共 Ed 帖子中。 相反，你可以使用每个作业的 Gitbugs 类别来发布私人调试帖子。

以下是一些适用于专门提出私人调试问题的指导方针：

贴上你的 GitHub 仓库链接，并且 push 到最新版本。: 这样我们有时候可以直接看你的代码，确保是最新的。 请提供你代码中存在疑问部分的截图。 : 我们会要求你提供截图，这样我们才能了解你在看哪部分代码。

描述 bug 的时候，请务必具体。 : 像“所有内容”、“它不起作用”、“自动评分过不了”、“我不知道”这样的描述都太笼统。 如果我们不知道哪里出了问题，我们就无法提供帮助。 至少，你应该告诉我们哪个测试失败了，或者你看到了什么错误，即使仅仅这样并不能保证第一次回复就会有帮助。

如果你能找到一小段代码，比如某个方法或者几行代码，发现它们和你想的不一样，那就更好了！告诉我们你发现了什么，哪里不明白！

我们希望你已经尝试过 debug。 告诉我们你学到了什么。 : 这一点和上面的建议是一样的！ 如果我们看不出来你尝试过debug，我们是不会直接帮你debug的，而是会先问你都试过哪些方法。 截图能帮大忙，记得解释清楚截图中都有些什么，你在看什么地方！

Ed 提示与技巧

更改你的电子邮件设置以减少收到的电子邮件。 : 在右上角，点击你的头像，然后点击“设置”，然后点击“通知”以调整你从 Ed 收到的电子邮件数量。 公告邮件肯定能收到。

关注你想要了解更多信息的帖子。 : 如果你看到一个你想跟踪的正在进行的问题，你可以：

• 点击问题右上角的“关注”选项以接收电子邮件更新，或者
• “星标”问题右上角的帖子，以将其固定在你的 Ed 上。

引用其他问题、回答和评论：可以用 #N 的形式 (比如 #1 或者 #1c) 来引用其他帖子，这样比较清楚。 你可以使用它来提供重复问题的答案，或者指出你尝试过但没有奏效的事情。

让代码 (和堆栈轨迹) 更易读：使用编辑器里的代码格式化工具，代码会更好看。 语法高亮显示的代码比文本形式的代码更容易阅读。

如果你有关于个人事项的问题，不想让其他学生看到，请发表私人帖子。 仅课程工作人员可见。 如果你只希望主管助教和 Josh 看到你的问题，请发送电子邮件至 cs61b [at] berkeley.edu