通用工程介绍/教程
实际的 教程 存在！
对一个人来说，日常的、简单的事情、常识性的东西，对另一个人来说是神秘的。一个叫不出螺丝刀名字的人，会对所有这些技巧感到迷惑。玩弄 PID 软件对那些没有学习过控制课程的人来说是个谜。 优秀的教程 需要写作技巧。开始写教程并不需要。
支架是指讲师通过讲课来推动项目前进。讲师可能只是在黑板上写字。讲师可能会发放讲义或提供动手活动。讲师可以单独进行，也可以对团队或整个班级进行。重点是，讲师这样做并不是为了创建教程。从这种练习中受益的人或团队被期望将讲座变成教程。
项目支架的目标是尽快掌握最新信息，以便能够高效地推动项目前进。如果没有支架，大多数学生会把所有时间都花在学习项目上，而不是实际做项目。
大多数大一和大二的工程项目并不是关于支架的。目标是教授设计和解决问题的技能。内容只是为了服务于这些目标。
除了讲师，其他工程师，甚至学生，可能也会有一些宝贵的信息可以帮助你推动项目前进。你的目标是捕获、拥有，然后将这些信息传递给世界。否则，这些宝贵的信息就只会停留在人们的脑海里，在不同的大脑之间口头传递，并受到空间、时间和语境的限制。
例如，一个讲师亲自演示如何测试 Arduino 是否正常工作。你可以打开 ardenialin 并记录下每一个按键，让讲师放慢速度，强迫讲师和你说话，而不是在键盘上飞来飞去。你可以让讲师向你展示什么是可能的，你将自己弄清楚细节。
你应该做的是，不要对自己说，“哇，讲师知道这个，所以我不用学。当我下次需要这样做的时候，我可以再问他”。不要对自己说，“可能每个人都知道这个，我真是个傻瓜”。不要对自己说，“所有的工程师都知道这个，所以我问问其他讲师或助教就行了”。工程师不会参与群体思维、群体意识、群体知识。群体思维会蒙蔽工程师。群体思维会让所有工程师都变得一样。平庸开始占据主导地位。
不要指望通过利用集体智慧来成为一名工程师。当一个工程师在和你说话时，把它当作一份礼物…一份独一无二的礼物，只有工程师知道，并且正在传授给你。如果有人在白板上涂鸦，而你的团队中没有人把它写下来…无论对错，是否合乎目标，是否有用，都应该把它记录下来，最终将其纳入团队文档中。
当一个问题非常顽固时，最好不要寻找教程或支架。顽固的问题是那些其他工程师已经尝试过但没有解决的问题。倾听他们的故事，阅读他们的尝试，会让那些刚接触这个问题的工程师感染上同样的病毒，蒙蔽他们之前的工程师。当目标是截然不同的东西时，需要来自截然不同背景的工程师…没有现有的支架/教程。另一方面，如果目标是逆向工程，如果目标是复制，那么支架和教程是绝对必要的。
真正有艺术感的工程师会拒绝记录，因为他们认为下一代工程师应该自由地创造全新的东西。然而，这不是工程师的特权。这是客户的特权…就是支付工程师工资的人。
欢呼吧。你将要学习一些新东西。你将要扩展你的工具集。你将要成为一名更有价值的工程师。你可能有机会先做一些事情。
如果你不知道如何做某件事，你应该期望存在一个优秀的教程来教你如何做。如果教程不存在，那么这是世界的问题，而不是你的问题。更重要的是，你还有机会通过创建/编辑教程来改善世界。
假设你知道如何用焊锡穿孔，但对表面贴装焊接一无所知。什么更有价值呢？
- 一个关于这个主题的随机 YouTube 视频
- 或者一个视频展示如何使用你的学校积累的设备
你的目标是根据随机的 YouTube 视频创建教程。如果已经有了一个教程，你的目标是改进教程或快速浏览它。
一个优秀的教程看起来像一棵树。你从根部开始扫描，一直向上工作到叶子。一个优秀的教程意味着你沿着熟悉的树干向上移动到熟悉的树枝，直到你找到一些新的东西。你放慢速度，掠过一片叶子。也许这片叶子不是你想要去的地方。你退回到熟悉的地方，然后爬向另一片叶子。你继续识别你不想知道的东西，直到你找到你想学习的东西。然后重新跟踪你从熟悉的地方到目标叶子的路径。在你完成教程的过程中，使用维基标记工具 编辑教程…而不是 事后编辑。
教程是维基versity 中的文章。维基教科书包含分组到书籍中的文章。通用工程教程在维基versity 上被 分类。在维基versity 上有 最佳实践 的方法来创建教程。
不要试图写一本教科书。不要试图追溯到最初的根源哲学概念。不要试图做到完美。记录你的团队为了成功而做的事情。不要担心你的读者。为你的讲师而写。如果你的讲师能理解，你应该能得到一个好分数。让其他遵循你的步骤的人改进教程。不要为自己而写。你的逻辑、你的符号、你的天赋可能是独一无二的。你的讲师会更好地了解什么是“完整”、“详细”和“标准”。
不要相信教科书的章节是逻辑相关的。教科书通常是对主题的调查，它们通过一条非常薄的逻辑线索来组织顺序。教程不应该以这种方式对待。
将教科书视为主题调查，就像搜索结果一样。跳到看起来相关的部分，然后开始阅读。记下你不理解的词语。开始对这些词语进行分类，就像它们是谜题的线索一样。建立到更详细解释的链接。
教程是关于科学、数学或技术的。工具及其使用是技术的一部分。与工具以各种不同方式使用一样，相同数学应用于各种学科。工程项目是设置教程使用和重复使用上下文的因素。预计教程图片会被重复使用，并在一个教程与另一个教程之间形成多对多关系，而不是层次树形模式。创建步骤的主页，然后链接到步骤。理想情况下，其他人可以创建主页，包括其他步骤或将步骤放在不同的位置，跳过步骤等。相同的步骤成为其他教程的构建块。
并非所有人都遇到相同的挫折。并非所有人都卡在同一个地方。不同的人真是令人惊叹。不要以为你不会就认为自己很蠢。世界很蠢，很偏见，没有预料到你的挫折。改变世界。改善世界。在忘记之前，通过立即修改教程来捕获你的挫折。
不要等到世界或你自己的完美，才尝试工程。
工程笔记本 90% 是错误的，因为它们记录了工程师卡住的地方。阅读工程笔记本让人完全困惑。其他人的笔记本不是寻找教程的地方。
但是工程笔记本，如果在做的时候写，就会包含创建教程所需的所有细节。教程步骤可能没有顺序。细节可能在 90% 的页面上都是错的。成果可能在一个页面上的一句话中。组织这些信息是教程的目标。
不要犯这样的错误，试图让你的笔记本看起来像教程。
个人 wikiversity 页面包含笔记本混乱的反思或扩展。信息按时间顺序排序，就像笔记本一样，并扩展了图片和链接。另一方面，教程是步骤或起点的列表。
教程的确切细节很重要。创建最好的教程很重要。但教程细节并非最重要的东西。
大多数维基文章的细节来自一个人。其他人会来进行一些小的编辑。这篇文章可能会在其他人查看它之前停留 5 年。而且他们很有可能会链接到它。
创造历史。成为第一作者。通过准确描述教程的目标并为其提供相关的 wikiversity 文章名称，为本教程创建一个占位符。不要担心它是否完美。其他人将在未来修复细节、澄清并添加内容。
教程/文章占据了维基上的空间。它被链接。它的使用被记录下来。个人而不是人群查看它。在你所到之处添加价值的传统……如果你能做到。既创建原创作品，也编辑他人的作品。