跳转到内容

一般工程学导论/笔记本/项目写作

来自维基教科书,开放的书籍,开放的世界
blank engineering notebook opened to page 62,63.
一个开放的工程笔记本。

项目写作三部曲

[编辑 | 编辑源代码]

项目写作需要在左边空白处写下三个词:GoingToDo、Doing 和 RANT。 老师会读这些词并进行计数。 更多细节请查看课程大纲。 没有 RANT 不会得到任何分数。 多个简短的三部曲比一个长的三部曲得分更高。 多写 RANT。

GoingToDo、Doing 和 RANT 的目标是鼓励在项目进行之前、期间和之后进行写作。 不要事后写作。 这样写出来会显得生硬、不自然。 项目写作一开始会让人感觉缓慢、效率低下且毫无意义。 几个星期后,重新阅读。 然后价值就会显现出来。 玩耍会变成工程。 学习的冲动会来自内心,而不是来自外部世界。 慢下来会加速,超过那些非工程师。 写作会得到提高。 现在就开始。 不要抵抗。

GoingToDo

[编辑 | 编辑源代码]

它通常来自于之前的 RANT。 有时它完全不同。 不要担心逻辑一致性。 笔记本应该充满混乱。 它不是一本书。 其他人可能会阅读它。 混乱的本质提高了时间顺序的完整性,它更令人尊敬。 它真实。 我们的记忆比当时的现实逻辑性要强得多。 GoingToDo 应该捕捉意图。

GoingToDo 不会记录或证明所花费的时间。 不要写下琐碎的事情,除非有工程上的理由。 不要写下:“要上传图形”,除非你以前从未做过。 在你的笔记本中写下同一件事 40 次并不会给你带来 40 个三部曲分数。 预计在电子文档中获得“工作”项目分数。

所做的事情不必与 GoingToDo 相匹配。 目标是做一些事情。 这里是画画的地方。 笔记本中的图画应该是快速草图、表格、简笔画。 在 1980 年之前,工程学的第一门课是关于如何画…蓝图。 今天,学习在电脑上画画。 写下关于电脑工作的笔记。 描述图纸、文件名称、它如何有利于项目、它在项目维基中的位置。

网络探究(参见研究维基页面)应该记录在这里。 你在搜索什么关键词? 结果中有哪些模式? 为什么或为什么不放弃特定的搜索? 这是如何证明否定…证明某件事尚不存在。 正确地做到这一点是赢得尊重的最快途径。 如果有人不信任你,并且觉得有必要自己检查,你就失去了尊重。 如果你没有记录网络探究,这种情况总是会发生。 一个网络探究包含许多 GoingToDo、Doing、RANT 三部曲,而不是一个。

Doing 应该记录编程过程。 概述单元测试。 描述你目前正在进行的测试。 描述从 GIT 下载的软件包。 有关该过程的更多详细信息,请参见编程项目。

记录成本、产品描述、购买地点和数量。 画出工具的图片。 描述如何安全地操作、配置和存放工具。

工程从玩耍开始,然后进行实操,再进行设计,最后解决问题。 Doing 是从实操过渡到设计的关键环节。 工程设计是开始整理问题、利用模式和综合新创作的阶段。 可交付成果通常是使用适当的设计工具创建的电脑文件。

好的 RANT

[编辑 | 编辑源代码]

RANT 代表 Reflect(反思)、Analyse(分析)和 NexT steps(下一步)。

至少,RANT 是一个快速记录下一步行动的文字…在注销、吃午饭或其他休息之前。 目标是记住休息前你在哪里。

RANT 是三者中最重要的一项。 没有它,就无法穿越混乱、迷雾和不确定的森林。 如果卡住了,尝试回答以下适用的问题

什么做得对/错
为什么某些事做错了
数字中内置的错误是什么
如果有更多时间,会做…
这项工作更合适的工具是…
如果能重来,会…
如何更准确地完成…
如果能自动化,会通过…来改进数据
这是预期
这不是预期(预期是什么?)

RANT 为下一个 GoingToDo 做准备。

糟糕的 RANT

[编辑 | 编辑源代码]

RANT 通常在出现“我”这个词的时候就会变得糟糕。

  • "我认为它不会成功,因为我没有足够的时间去做。 五个小时过去了。 我也没有制作第二个圆柱体。 所以我认为它不会成功。"
  • "我很高兴,我认为我很快就会完成。"

RANT 不是反思。 下面是两个不应该出现在笔记本中的反思例子。

  • "通过这个项目,我了解到我们应该更早做准备,因为这可以帮助我们避免匆忙行事。"
  • "我了解到我们应该在开始之前制定一个完整的计划。"

糟糕的 RANT 用意见代替了事实

  • "弯曲衣架比预期更困难。"
  • "需要非常细致的工作。"
  • "这会成功。 架子会运行,水会流到上面,压力也会施加到上面,所以它会让架子运行。"

好的 RANT 坚持事实,让读者得出结论。

  • "排量器上下移动相当平稳,钉子很好地固定了杆子,使其保持直立不动。"

好的 RANT 为下一个三部曲做准备。

  • "需要想点办法防止曲柄在转动时左右移动。"

典型评分标准

[编辑 | 编辑源代码]

老师通常会要求所有团队成员的笔记本。 首先会扫描写作模式。 平均每页约 3 个三部曲,代表大约一个小时的工作。 每页更多三部曲通常是琐碎的,不会被计入。 更长的三部曲会导致老师责备你将它们拆分。 然后对三部曲进行计数(琐碎的会被扣除),并乘以每个三部曲的分值。

通常,所有项目团队的笔记本都在课堂上,当着其他人的面,同时进行评分。

不要事后写作

[编辑 | 编辑源代码]

最大的障碍是学习在项目进行之前、期间和之后进行写作。 如果你去商店寻找零件,随身携带笔记本。 在商店里,在笔记本上写下你的想法。 试图事后回忆和写作会导致三部曲和分数减少。

不要创作一本书

[编辑 | 编辑源代码]

这不是英语课。 混乱的、半成品的、划掉的、错误的、完全错误的、愚蠢的错误的想法、主意和图片都是预期的。 工程笔记本中的大部分内容都是错误的。 当事情按预期进行时,就会创建电子文档,笔记本中的写作就会停止。

不要试图写一本完美无缺的书,让别人阅读。

其他人会阅读你的笔记本,寻找你尝试过的但没有成功的方法。他们希望找到你卡住的地方的描述,以便与他们卡住的地方进行比较。他们希望找到你通往偶然成功的步骤。

请记住,成功只是工程笔记本中很小的部分。

华夏公益教科书