kennyleunghk

都係最簡單既道理, 你係個客

1. 寫好既文件, 無程序
2. 寫好既程序, 無文件

你自己揀一樣, 邊個重要些 ...
gn01119056 發表於 2023-8-15 17:28

    我想問個問題, 點解只能二選一?

我做幾個大project 份contact都講到明唔同時間要交唔同嘅野
document 點都要俾客, 只係睇contact 交幾多料, 少極都要俾program spec
就算你成個project 都連埋後續main 都係vendor做埋一樣大把document 要交

Sorry 我未聽過有個project documentation / code二選一, 定係我做開果D project 唔夠細?

gn01119056

我想問個問題, 點解只能二選一?

我做幾個大project 份contact都講到明唔同時間要交唔同嘅野
docume ...
kennyleunghk 發表於 2023-8-16 14:55

    點解二選一?
因為有人話文件比較重要的謬論, 不是我首先提出的
有人提出要比較誰重要, 就會出現二選一
我一早說明兩樣野無衝突
話文件都重要係絕對無問題
但話文件比程式重要就好有問題
如果要揀就一定程式更重要, 已經係無得爭論既事實, 基本邏輯

kennyleunghk

點解二選一?
因為有人話文件比較重要的謬論, 不是我首先提出的
有人提出要比較誰重要, 就會出現二選 ...
gn01119056 發表於 2023-8-16 15:27

    啱呀
文件重唔重要係高層早期傾個project時就決定
不過我近期幾份工下面D同事個documentation skill 都相當麻麻, 所以跟本唔係重唔重要問題, 只係佢地做得差就話唔重要咁解
因為好多developer 都普遍覺得document係多餘, 甚至連markdown 都唔識寫

天下無雙

not really, 唔係個個客都需要doc 嘅, 我好多客都只係需要個program, 而佢本身公司可能連IT staff都冇, s ...
7h1r733n 發表於 15-8-2023 22:33

呢層當然個客agree既就無問題啦....有人要挑出黎話一定要2選1呀嘛..

KinChungE

我想問個問題, 點解只能二選一?

我做幾個大project 份contact都講到明唔同時間要交唔同嘅野
docume ...
kennyleunghk 發表於 2023-8-16 14:55

我諗佢意思係

1. 有冇客話只要文件, 唔要program?  冇
2. 有冇客話只要program, 唔要文件?  有

咁就反映program係必需
文件唔係一定必需, 要睇個別project

唔係真係叫人二選一

gn01119056

我諗佢意思係

1. 有冇客話只要文件, 唔要program?  冇
2. 有冇客話只要program, 唔要文件?  有

咁就反 ...
KinChungE 發表於 2023-8-18 01:37

    網上既人係會左兜右兜講到自己岩
程式就係最主要既野, 佢地講到文件重要過程式
自己都知自己講既野有問題, 之後就左兜右兜
一開始都講左, 兩樣野無衝突
話文件都重要係絕對無問題
話文件重要過程式就好有問題

程式就係件貨, 成個Project最主要既野
文件重要性一定次於程式
基本上係無需要討論既野, 佢地都可吵

fred2088

一般不懂的公司管理層, 要的是 :
System Requirement
交貨要有 System Spec, System Flow  等大路外圍東西

到落手落腳做的也分幾個層次 :
跟公司以後改系統的也要看上面的文件及再 Detail 的 Unit Spec, Functional Spec, Program spec, 等
邏輯分析及找Bug的 是看 Comment trace ...

gn01119056

一開始都係一手交錢一手交貨(程式)
慢慢先再衍生Document, support, ‎maintenance, workflow 各式各類既野...
程式就係最主要果樣野, 唔可以有問題, 一定係最重要, 先到其他野
可以本末倒置, 真犀利

fred2088

回復 38 #gn01119056

睇下你個system係大定係細, 一般大系統是以文件開始, Finalized 左先至開波

via HKEPC Reader for Android

gn01119056

回復 gn01119056

睇下你個system係大定係細, 一般大系統是以文件開始, Finalized 左先至開波

via HKE ...
fred2088 發表於 2023-8-18 15:27

    一早講左, 你可以話文件都重要, 缺一不可
但無可能話文件重要過程式
Document, workflow都係為左個System衍生出黎
你只能講文件都好重要, 或同樣重要, 我一路都認同
如果話文件重要過程式有問題

一直都好簡單:
1. 文件有問題, 或者無文件
2. 程式有問題, 或者無程式

邊個更重要, 係完全無需爭議