一般工程簡介/文件
除非其他人能夠在沒有你的情況下...沒有你的指導...沒有你的人格存在的情況下...複製你所做的事情，否則你不能算是一個工程師。
工程文件主要有四種形式：筆記本、專案、教程和演示。以下重點介紹專案文件。專案文件是電子的，分為兩類：個人和團隊。
製作是指設計師直接製作文物。這沒有文件。其他人無法制作文物。埃及金字塔、萬里長城、瑪雅神廟都是製作出來的。展示、交談和實踐與工程無關。因此，我們今天只能推測它們是如何建造的。
貿易或手工業經濟在沒有文件的情況下已經存在。沒有工程師。現代世界依賴於工程師的文件。
歷史上存在著許多天才，未來也會有。但如果沒有文件，沒有人能夠修復、改進、複製或解釋。如果沒有文件，天才的成果將消失。
複製是工程文件的主要目標。
複製涉及為兩個截然不同的受眾記錄：技術人員和其他工程師。技術人員希望能夠準確地重複你的步驟以獲得成功，這導致了教程的產生。工程師將閱讀這些教程以更快地瞭解技術的未知邊緣。但工程師還需要其他東西。他們想知道團隊是如何組織起來進入未知領域的。工程師想知道如何識別死衚衕。工程師想知道導致失敗的症狀、錯誤資訊和故障模式的詳細資訊。工程師想知道任務是如何分配的。這被稱為專案或問題文件。
文件可能比材料更昂貴。現在的飛機都是沒有進行實物世界測試就製造出來的。有關飛機的資訊建立了模擬，現在這些模擬能夠準確地預測成功。一些農作物的資訊成本超過了種植和收穫的成本。山核桃的採摘、脫殼、去皮、乾燥和包裝的成本低於運輸成本。資訊（包裝、運輸、營銷、支援、生命週期）也需要工程設計。工程服務或軟體純粹是工程資訊。這就是為什麼一些工程入門課程只對文件進行評分，而不是對實物成功進行評分。
人員、時間、動手經驗都很昂貴，而且越來越昂貴。能夠在沒有實物建模、沒有購買套件、沒有大量破壞性測試的情況下進行設計的工程師將會更加成功。
政府強制要求某些工程學科對所有設計檔案進行檢查。美國的專業工程師擁有一個浮雕印章，用於在經檢查的檔案上蓋章。
工程檔案必須建立。有時它們有成千上萬頁。參與其中的工程師主要有三個群體：代表政府利益的工程師、設計橋樑的工程師和建造橋樑的工程師。同一家工程公司只能做這三項工作中的其中一項。這促使了文件的建立。工程文件成為專案的根基、起點和核心，而不是單個工程師。這些法律和程式實踐促進了土木工程文件的演變。
更新的工程學科似乎不得不重新學習這種道德準則。一個人的思維無法考慮到所有需要考慮的可能性。一個人也無法輕易地從創造性思維轉變為詳細檢查的思維方式。才華無法消除這種需要。一個“貸款發放”軟體包被銀行分支機構拒絕了。問題是？該軟體是由一位天才工程師“製作”的。
只有在從一位工程師轉移到另一位工程師時，設計檔案才會脫離相關人員的個性而發展。在軟體工程領域，結對程式設計和單元測試的紀律實踐正在探索檢查方法。
必須挖掘一群工程師的集體智慧。孤獨的天才工程師可以被發現，他們在一些試圖建立專利組合的公司中被隔離和獨自工作。但這很罕見。必須收集所有工程師的意見，包括公司之外的工程師的意見。收集意見、建議和資源需要一個團隊工程師共同完成專案文件。
只有在從一位工程師轉移到另一位工程師時，“最佳實踐”文件標準才有機會發展。開源軟體開發是軟體工程的開始，因為它為軟體文件提供了一個起點。軟體很重要，因為如今所有工程的很大一部分都圍繞著模擬、資料收集和分析。使用任何軟體包都涉及某種形式的程式設計。
每家工程公司都有自己的專案文件方法。失敗的專案、開放式專案和正在進行的工程專案與“成功”專案的文件方式非常不同。成功的專案文件很快就會變成操作理論、維修手冊、操作手冊等。本課程的目標是在大學一年級工程專業的背景下教授工程文件。
一般工程專案的目的是用以下目標來捕捉工程的創造性設計過程：
- 其他人可以加入，找到一個起點，並將專案推進
- 現有文件作為腳手架，可以快速建立專業知識
- 專案經理/講師可以檢視以前的任務演變、時間和消耗的材料，以便進行計劃
- 讓非專業讀者/其他工程師有機會閱讀問題並提出解決方案
- 成為特定型別專案的最佳實踐實施方案
你需要在兩個地方對你的工作進行電子記錄。你需要兩種型別的資訊在你的指尖。一種型別可以在網際網路上找到。另一種是個人且安全的。你的實物筆記本是最終的安全保障。你需要建立自己的安全個人電子檔案儲存庫的原因有很多
- 網際網路資訊瞬息萬變，您可能需要一個過去的快照。不要依賴於網際網路檔案館。
- 大多數人把自己散佈在整個網際網路上。四年後，在求職面試中，你真的能夠找到你在 Facebook 上釋出的酷炫帖子，或者你寫在別人部落格裡的回覆嗎？
- 工作會找到你。公司會檢視你的線上作品集。
你寫的每一篇論文，你畫的每一幅畫，你上的每一門課程的教學大綱，你掃描的每一份作業問題，你收集的每一位元資料，你建立的每一項模擬，你編寫的每一個程式的每一個版本，你建立的每一份簡歷，你拍攝的每一張照片和影片，都需要觸手可及。將來你會需要它們。那些擁有這些資訊的人會得到更好的工作，參與到更好的專案中，並減少對證書和學位的擔憂。有些人認為，大學教育體系將從學位轉向作品集。你需要開始收集構建作品集所需的原始資源。你可以在哪裡以及如何做到這一點，可能是
- 硬碟驅動器（硬碟驅動器最終會損壞）
- U 盤（這些最終會被丟失或感染病毒）
- 學校建立的個人資料夾（當你畢業或不支付賬單時會消失）
- 網際網路雲：谷歌雲盤、Dropbox（或競爭對手）（擔心隱私、免費服務消失）
沒有完美的答案。最好的前網際網路工程師也可以立即找到所需部件的正確目錄，所需解決方案或類似過去專案的文件。在網際網路出現之前，不是擁有最佳思維的工程師，而是擁有最佳紙質組織系統的工程師獲得了最大的尊重。現在，最受尊敬的工程師可以找到 3 年前的電子郵件附件。
截至 2014 年秋季，這是最佳實踐。
- 如果你拍的照片，請上傳到維基共享資源
- 不要將合理使用 他人的圖形作品上傳到華夏公益教科書
- 建立一個華夏公益教科書 ID，並在維基使用者：空間中建立一個個人資料
- 在維基使用者空間中進行所有編輯，完成後再轉移到華夏公益教科書文章空間
- 將影片上傳到 YouTube，建立帶有“影片”字樣和影片描述的公共連結
個人週報
[edit | edit source]個人週報以維基格式完成，並在華夏公益教科書中進行。
個人週報的評分分為三個部分
- 形式…電子文件以敘事形式連結，遵循維基格式
- 溝通…為團隊建立每週任務，對每個團隊成員進行正面評價，完全透明，以便經理能夠看到誰做了什麼
- 工作…推動專案向前發展，而不僅僅是在個人學習曲線方面工作，以及/或者幫助在華夏公益教科書頁面上建立設計文件
工作點數是用於“推動”專案向前發展和設計。這意味著做一些有意義的事情。這是個人認可和獎勵。推動點數與努力工作、金錢、大量時間、失敗或成功無關。推動點數是根據詳細記錄、所採取的步驟以及花費的時間來授予的。失敗將導致更多點數。成功通常會產生教程。
對本週發生的事情進行口頭總結不會給你任何推動點數。例如，寫下“我嘗試執行 Android 戰鬥控制器，但失敗了”，不會給你任何專案點數。問題不在於失敗，問題在於沒有描述失敗。在哪個計算機的哪個虛擬機器上，執行哪個版本的 Android 作業系統和哪個戰鬥控制器？錯誤資訊是什麼？找不到 Wi-Fi 還是無法訪問 SD 卡？注意失敗，並開始提出 1000 個關於它的問題。
所有失敗、所有文件都將進入與講師協商的 CDIO 文件。CDIO 文件的名稱，它的綱要，就是所有專案文件存放的地方。大多數情況下，該文件將由一個人建立。團隊中的每個人大部分時間都會處理一份 CDIO 文件。然後，它將由團隊成員進行檢查，並由團隊成員在團隊完成時授予釋出許可權。
大多數 CDIO 文件內容來自你的筆記本。你筆記本中寫下的混亂和挫敗感被整理起來，並簡化為簡短的旁白。你在筆記本中寫字時拍攝的照片和影片隨後被組裝成 CDIO 文件中一個引人入勝的故事。
通常情況下，形式和合作點數有固定的最高值。推動點數沒有限制。推動點數可占課程總成績的 10%。
同行評審
[edit | edit source]對你的團隊成員說一些關於他們自己的積極的話。練習讚美。計劃它。不要指望它在你心情好的時候會自發地從你的靈魂中迸發出來。
大多數學校都有一個支援服務系統，當學生停止參與時，該系統就會啟動。如果團隊成員不互相關心，大多數這些服務都是無效的。遇到問題的人往往尋求幫助太晚。由團隊成員來觸發這些服務。如果一個團隊成員沒有工作可供審查，請與他們溝通。將此事轉告給講師，以便學校的支援服務能夠做好他們的工作。
團隊
[edit | edit source]我們
[edit | edit source]CDIO 文件的目標是隱藏個性。從“我們”的角度來寫它們。你可能會得到幾年以前或昨天別人的 CDIO 文件來進行改進。一些 CDIO 文件由幾個人同時進行。
工程公司通常在團隊成功時獎勵工程師。公司內的個別工程師是公司秘密的、寶貴的、隱藏在公眾視野之外的資產。
許多工程專案可以無限期地繼續下去。它們可以分支、分叉、改變方向以及合併。文件也是如此。任何以“我”的視角寫的東西看起來都不合適。
工程專案永遠不會完成。總是有可以想到的下一步。但是專案文件有明確的界限。這些界限是由專案經理設定的，他們試圖預測時間、材料、人員、資金和空間。這些資源在業務方面結合在一起，形成了與利潤相關的完成定義。“足夠好”捕捉了這種型別的“完成”。
專案文件是工程師將專案責任傳遞給另一個團隊的方式。工程專案永遠不會“完成”。每個工程團隊通常只完成一個更大、多團隊或多年專案的很少一部分。
本課程的目標是在專案上以平穩的速度工作。不鼓勵在最後一刻或第一週快速完成專案。
專案文件的最小綱要可以在華夏公益教科書中找到。
專案成功
[edit | edit source]如果一個專案解決了問題陳述中描述的問題，那麼該專案就被認為是成功的。問題陳述是一個可以修改的流體文件，需要徵得客戶（或講師/專案經理）的同意。
設計
[edit | edit source]工程設計是本書的下一個主要部分。它們首先被大致地組織成藝術、科學和商業類別。最終，這些類別之一將主導一個工程專案。首先學會用這些術語思考，而不是機械、電氣、土木、化學或生物工程。
設計中的紙質工作/文件部分側重於CDIO，它列在商業部分，工程公司“尚未成功…失敗”的工程文件是其隱藏的價值。在這種情況下，個人和團隊在建立 CDIO 文件時可以執行更具體的任務。