iT邦幫忙

1

某科大準畢業生!!! 要謝謝論壇的各位大大...還有詢問Github的問題!!!

  • 分享至 

  • xImage

如標題 先謝謝論壇有幫忙的各位大大!!
我是先出去社會工作後 25歲回來念高中28歲念大學的
現在31歲得到實習機會正在科技業實習!!!
高中學資料處理 如果基礎的不會還可以看網路教學 還蠻容易上手的!!!
但是大學的PHP SQL Python 看教學或說明!!
真的就比較不好理解了~
大學這些年就常常上論壇詢問各位大大的幫忙!!
也都能得到基本解答 後來就可自己寫語法了!!!
所以 要謝謝各位有幫過忙得資訊人 讓我現在也能成為資訊人!!!
(畢竟當初沒唸書 打工做了3.5年(16-19.5)/做工做了4.5年(21~25)XD 現在轉變為資訊人 認識的每個人都真的佩服我!!!)
"------------------------------------------------------"
主題:
現在有一個問題...
我使用Python 的 pyqt寫出一個程式
有ui 填入相關數值後
可使用web api給機器做相關事情
前輩說...好!
程式差不多了...
那就把部分內容加強優化後
語法寫上註解
(然後還說甚麼可以註解上自己的小名跟信箱 說不定會有公司找XD)
然後可以開始寫readme
註解原本就有寫一點了(方便判斷語法錯誤)
(優化也簡單)
只是readme我真的不知道要怎麼寫= =!!
雖然網路上查大概懂..
是要寫介紹這個專案程式相關簡介(目的 功能 用途 使用方法 來源)
但是又看到放在甚麼githib內的readme
(我以為只是程式資料夾多一個word檔XD)
所以就...打結了!!!
想麻煩各位資訊業的前輩大大...
提供點意見照顧大四資訊業實習生的我~
謝謝!!

看更多先前的討論...收起先前的討論...
淺水員 iT邦大師 6 級 ‧ 2022-11-13 11:25:09 檢舉
readme 跟你在這邊發文的語法差不多
都是 markdown

不過你把標題當作讓字加大的方式應該不是正式的用法
sky800219 iT邦新手 5 級 ‧ 2022-11-13 12:20:17 檢舉
抱歉抱歉
我只是在中間加分隔線
"--------------------------------------------"
可是忘記前後" "了
結果上面就變成粗體!!!
shiaobin iT邦新手 4 級 ‧ 2022-11-14 12:39:26 檢舉
這裡有個不錯的參考資料。

README 寫法 | QWERTY
http://gitqwerty777.github.io/art-of-readme/
sky800219 iT邦新手 5 級 ‧ 2022-11-14 20:12:48 檢舉
好的 謝謝大大!!
我等明後天程式碼註解完成
同時程式測試結束
就可以來好好寫readme了!!
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中
2
tryit
iT邦研究生 4 級 ‧ 2022-11-13 15:18:04
最佳解答

當你不知道readme怎麼寫的時候應該是請教你的主管會比較好
首先readme是用mardown語法->markdown語法有哪些格式餵狗都找得到。
內容的部分你也打出來了

是要寫介紹這個專案程式相關簡介(目的 功能 用途 使用方法 來源)
也就是說,你就用markdown語法下好主標。接著根據主標分幾個副標把該打的打上去就好。
大概像這樣吧

回復文章:主旨


此回答的目的是為了示範如何使用markdown語法建立一個簡單的readme文件,基本上就把想打的事情打上來,然後把內容跟主管討論(若真的不熟)

我自己寫的時候會注意的東西


  1. 簡單介紹
    1. 要讓一個不知道這在幹嘛的人,大概知道在幹嘛
    2. 用到了什麼語言、工具等等
  2. 內容物
    1. 運用的工具/語言
    2. 運用的資源(video or photo)
  3. 執行環境↑上面是概括,這邊要詳細講版本,以及一些細節
    1. 細節
    2. 細節
  4. 安裝步驟
    1. 怎麼安裝你剛剛說的執行環境
  5. 支援
    1. 遇到麻煩時可以問誰,基本上你是開發人員就填自己(X),要走就填主管或不寫(O)
    2. 可以參考哪些資料若遇到麻煩的話
  6. 須注意的特殊事項
    1. 什麼東西絕對不要動,或要動絕對要注意什麼之類的
  7. 使用者操作手冊
    1. 這程式給使用者後有什麼操作流程之類的

結語


固定會寫些抱怨的東西

我的話會這樣啦,但老實說我也沒很常做這些東西,就只是參考用而已,每個地方都有最適合的格式,真不知道怎寫最好問過主管,知道他所要的內容,投其所好絕對比自己覺得完美好。

話說IT邦幫忙也是用markdown語法,你可以看看
https://ithelp.ithome.com.tw/markdown

看更多先前的回應...收起先前的回應...
sky800219 iT邦新手 5 級 ‧ 2022-11-13 20:26:20 檢舉

謝謝大大..
跟我原本概念差不多..
只是工具的問題..
"--------------"
簡單介紹
要讓一個不知道這在幹嘛的人,大概知道在幹嘛
用到了什麼語言、工具等等
內容物
運用的工具/語言
運用的資源(video or photo)
執行環境↑上面是概括,這邊要詳細講版本,以及一些細節
細節
細節
安裝步驟
怎麼安裝你剛剛說的執行環境
支援
遇到麻煩時可以問誰,基本上你是開發人員就填自己(X),要走就填主管或不寫(O)
可以參考哪些資料若遇到麻煩的話
須注意的特殊事項
什麼東西絕對不要動,或要動絕對要注意什麼之類的
使用者操作手冊
這程式給使用者後有什麼操作流程之類的
"---------------"
簡單說就是類似畢業專題的報告差不多...
介紹這個專案作品的概念
只是 我不知道到底用甚麼表達!?
因為好像github 在專案的部分
有個區塊就是這個readme?
還是我檔案完成.然後就使用word打這些需求內容?
然後放在檔案資料夾內 檔名readme即可!?
這就是我現在頭最痛的地方= =
謝謝大大 抱歉表達能力比較不好 好像表達方向錯誤!!

sky800219 iT邦新手 5 級 ‧ 2022-11-13 20:48:23 檢舉

沒事沒事 謝謝大大給我一些方向~~
https://ithelp.ithome.com.tw/upload/images/20221113/20131917FW7CBGuHm3.jpg
好的 那我大概了解了!!
簡單說就是使用markdown語法
編寫readme相關要點在這邊readme.md
然後存檔
(大綱是這樣)
好的 那我明天上班就可以開始慢慢解決了!! 謝謝大大!!

tryit iT邦研究生 4 級 ‧ 2022-11-14 11:34:00 檢舉

太好了

sky800219 iT邦新手 5 級 ‧ 2022-11-14 20:13:15 檢舉

好的 謝謝大大!!
我等明後天程式碼註解完成
同時程式測試結束
就可以來好好寫readme了!!

1

說真的,我就直接講白好了。

你還算半桶水。
為何會這樣說?
一個不知道怎麼寫readme的,跟不想寫readme的人。是視全不一樣的
因為可以馬上理解 readme 要怎麼寫的人,一定是經驗很豐富的。
知道會碰上什麼要運行什麼要做啥....
寫個README根本不可能不會不知道怎麼寫。

最多是懶的寫。(我就是這樣的人...很懶的寫,但不得不寫)

一般來說,README大約就幾個大項

  1. 應用的名稱、版本、開發群或公司名,連結或連絡方式。
  2. 適合的系統、語言、可能性版本
  3. GIT的來源。(如果有)
  4. 安裝方式、過程及處理。
  5. 設定的調整
  6. 需要注意的事項(可有可無)

就約這幾個大項。

現在比較少寫對應的函式使用方法及方式。就算要。
只要你程式內的註解有寫好。其實都有對應的工具幫你生成的。

註解一般就大約如下

    /**
     * Notes:方法說明
     * User: 開發人員
     * Date: 開發日期
     * @param 傳入參數的說明(沒參數可無)
     * @return 回傳的說明(沒回傳可無)
     * @throws 對應的來源類別(這不一定要有,不過我大多是會留下,寫說明方便連結)
     */
看更多先前的回應...收起先前的回應...
sky800219 iT邦新手 5 級 ‧ 2022-11-13 20:22:01 檢舉

謝謝大大的指教..
因為還在認真學習當中..
#寫個README根本不可能不會不知道怎麼寫。
應該是說 我大概知道概念 需要寫甚麼...
只是 我不知道怎麼寫?也就是用甚麼工具去寫?
例如:
文件=word.
簡報=PPT
製作影片程式=超級多的
(抱歉 我表達能力比較不好)

sky800219 iT邦新手 5 級 ‧ 2022-11-13 20:48:38 檢舉

沒事沒事 謝謝大大給我一些方向~~
https://ithelp.ithome.com.tw/upload/images/20221113/20131917FW7CBGuHm3.jpg
好的 那我大概了解了!!
簡單說就是使用markdown語法
編寫readme相關要點在這邊readme.md
然後存檔
(大綱是這樣)
好的 那我明天上班就可以開始慢慢解決了!! 謝謝大大!!

原來我誤會了,抱歉抱歉!

PPT嘛...不會考量它了。寫起來麻煩。看得人也會覺得麻煩
WORD有時我也會用一下。
不過大多數是用來寫規範居多就是了。

readme.md 我得是可以給你我以前的學習心得。
當然了,得先了解其對應的符號及寫法。

但其實你可以參考許多github上的readme.md。
COPY下來改成你的,從中學習對應的做法跟應用
也可以順便學習人家的說明規劃,及符號用法。

再整理出一套你的規劃就行了。基本原則有遵守就行。

sky800219 iT邦新手 5 級 ‧ 2022-11-14 20:15:03 檢舉

好的 謝謝大大!!
我等明後天程式碼註解完成
同時程式測試結束
就可以來好好寫readme了!!

0
W.H.
iT邦新手 1 級 ‧ 2022-11-14 13:12:18

是GitHub,不是GitHib喔~

讀作「ㄍ一 ㄏㄚ ㄅ」(t是舌尖頂一下上齒齦,幾乎聽不到聲音,b的發音也很輕)

不要讀成「居哈ㄅ」。

sky800219 iT邦新手 5 級 ‧ 2022-11-14 20:15:22 檢舉

哈哈 謝謝大大!!
打字打太快 手誤了XD

我要發表回答

立即登入回答