找回密碼
 註冊
|註冊|登錄

伊莉討論區

搜索
請尊重及感激所有版主付出和奉獻迅雷電影正式開放,齊來分享!迅雷動畫正式開放,齊來分享!
火影食戟之靈催眠一拳超人動物方城神奇寶貝siro
終極國中integrit房仲家snower's326eva 0三國志13

休閒聊天興趣交流學術文化旅遊交流飲食交流家庭事務PC GAMETV GAME
熱門線上其他線上感情感性寵物交流家族門派動漫交流貼圖分享BL/GL
音樂世界影視娛樂女性頻道潮流資訊BT下載區GB下載區下載分享短片
電腦資訊數碼產品手機交流交易廣場網站事務長篇小說體育運動時事經濟
上班一族博彩娛樂
電腦新資訊電腦軟體討論電腦軟體資訊分享電腦硬體討論電腦硬體資訊分享電腦萌化版電腦系統 OS 討論電腦程式設計
電腦設計技術交流圖像設計及交流各類下載工具教學寬頻上網討論
查看: 13611|回復: 10

[討論] 公司自己的API沒文件[複製鏈接]

Rank: 2Rank: 2

帖子
435
積分
798 點
潛水值
16192 米
發表於 2017-7-1 10:57 AM|顯示全部樓層
我想問的是,像公司自己寫的API沒有文件,通常會知道有這個API可以用都是某個功能想不出來怎麼寫時,問資深同仁他才說有XXX方法可以使用,不知道其他人也是這樣的模式嗎?
我自己不喜歡這樣,比較喜歡有文件可以看,打一個比喻假設公司自己開發java也用它來寫系統,如果沒有API文件,你String要以(,)這個符號做切割想了半天想不出來,問了資深同事才說有XX方法可以用,不會覺得很幹嗎?
...
瀏覽完整內容,請先 註冊登入會員

使用道具檢舉

帖子
18
積分
18 點
潛水值
290 米
發表於 2017-8-4 01:32 AM|顯示全部樓層
若新密碼無法使用,可能是數據未更新。請使用舊密碼看看。
台灣做事就是這樣
作文件要時間~你跟老闆或主管給你時間作規格或說明文件...
難啊...
若瀏覽伊莉的時侯發生問題或不正常情況,請使用Internet Explorer(I.E)。

使用道具檢舉

帖子
946
積分
28 點
潛水值
3208 米
發表於 2017-11-25 02:44 PM|顯示全部樓層
若瀏覽伊莉的時侯發生問題或不正常情況,請使用Internet Explorer(I.E)。
自己的公司也差不多
重要的系統沒詳細文件  只有應付的文書說明....
老闆能省則省 要做的事情娜麼多又不請人
誰想花時間去做文件?
若有安裝色情守門員,可用無界、自由門等軟件瀏覽伊莉。或使用以下網址瀏覽伊莉: http://www.eyny.com:81/index.php

使用道具檢舉

帖子
114
積分
8 點
潛水值
4573 米
發表於 2018-10-27 10:48 PM|顯示全部樓層
若新密碼無法使用,可能是數據未更新。請使用舊密碼看看。
這問題其實多數的小公司都有,純粹是規模的問題而已,至於哪間比較好,適合的公司有適合的人
若有安裝色情守門員,可用無界、自由門等軟件瀏覽伊莉。或使用以下網址瀏覽伊莉: http://www.eyny.com:81/index.php

使用道具檢舉

  贊助會員

英文數學都輸幼稚園一點的工程師

Rank: 6Rank: 6Rank: 6Rank: 6Rank: 6Rank: 6

帖子
1076
積分
3420 點
潛水值
51043 米
發表於 2018-11-7 08:13 AM|顯示全部樓層
成為伊莉的版主,你將獲得更高級和無限的權限。把你感興趣的版面一步步地發展和豐盛,那種滿足感等著你來嚐嚐喔。
主要還是要看老闆的觀念
只是一般很多公司文件是不算績效的
所以你花太多時間寫文件結果可能就是老闆覺得你沒績效

有些比較有規模的公司會有把寫文件當成年度績效
所以真的還是要看公司看老闆





分享使你變得更實在,可以使其他人感到快樂,分享是我們的動力。今天就來分享你的資訊、圖片或檔案吧。

使用道具檢舉

Rank: 3Rank: 3Rank: 3

帖子
3443
積分
3998 點
潛水值
46190 米
發表於 2018-11-12 08:32 PM|顯示全部樓層
本帖最後由 kwj 於 2018-11-12 08:38 PM 編輯

其實這要看狀況,如果對於一間數十名工程師一起合作的公司,有 API 文件有可能會有些幫助。但如果到上百人的公司的話,API 文件大概也沒什麼用處了。實務上有很多「人的問題」會導致理想中 API 文件帶來的優點,在人夠多的情況下會完全消失。

舉例來說,十幾二十個人的團隊,基本上每個人之間合作至少還算緊密,遇到需要寫文件時,要統一風格是有點機會。但如果七十人以上的團隊呢?期待團隊中所有人都寫出類似風格的 API 文件是不切實際的。另外如果每個人每一週都能產生一個 API 好了,對於一個七十人的團隊來說,一週會有七十個 API 產生出來,半年就有 1,680 個 API,就算假設裡面有高達 8 成的 API 都是重複的,也會有 336 個不同的 API 被產生出來。你真的確定你能夠了解這所有 336 個半年內產生的 API 嗎?兩年後會增加到上千個,到時你還能了解嗎?在上千個 API 文件中,你有信心能夠找到你想要找的 API 嗎?而且是在很有可能每個人的文件寫作風格都有些不同的情況下(例如有些人用字不精準、或者用字太精準、或者用詞跟別人不同、.....)?
...
瀏覽完整內容,請先 註冊登入會員
所有積分大於負-100的壞孩子,將可獲得重新機會成為懲罰生,權限跟幼兒生一樣。

使用道具檢舉

頭像被屏蔽

  禁止訪問

帖子
35
積分
31 點
潛水值
520 米
發表於 2019-1-3 08:58 AM|顯示全部樓層
不意外,可以先將部分的程式碼看過一次之後再盡量用自己的方法配合,另外註解多加一點自成格式,這是我的建議
如果發覺自己無法使用一些功能或出現問題,請按重新整理一次,並待所有網頁內容完全載入後5秒才進行操作。

使用道具檢舉

Rank: 1

帖子
63
積分
93 點
潛水值
10145 米
發表於 2019-1-22 05:20 PM|顯示全部樓層
所有積分大於負-100的壞孩子,將可獲得重新機會成為懲罰生,權限跟幼兒生一樣。
前輩或主管手上應該會有文件吧 不然只能自己摸索了

使用道具檢舉

Rank: 4Rank: 4Rank: 4Rank: 4

帖子
6347
積分
4460 點
潛水值
85644 米
發表於 2019-3-19 01:05 PM|顯示全部樓層
若有安裝色情守門員,可用無界、自由門等軟件瀏覽伊莉。或使用以下網址瀏覽伊莉: http://www.eyny.com:81/index.php
最好是你的客戶要求 api 文件...

就算是公司裏面部門跟部門之間 也可以算是客戶關系...

有 api 文件 客戶安心, 你自己也安一點心...

要不然只能爬代碼了...

我們公司用 doxygen... 來寫文件... 不知道適不適用...
若對尊貴或贊助會員有任何疑問,歡迎向我們查詢。我們的即時通或MSN: admin@eyny.com

使用道具檢舉

帖子
371
積分
23 點
潛水值
5841 米
發表於 2019-4-15 09:49 AM|顯示全部樓層
如果發覺自己無法使用一些功能或出現問題,請按重新整理一次,並待所有網頁內容完全載入後5秒才進行操作。
kikuras 說的是,通常老闆都只給程式開發時間,沒有做文件時間
如果你是賣api的,老闆才會給你時間寫,因為客戶要。




如果你忘記伊莉的密碼,請在登入時按右邊出現的 '找回密碼'。輸入相關資料後送出,系統就會把密碼寄到你的E-Mail。

使用道具檢舉

Rank: 1

帖子
59
積分
185 點
潛水值
9721 米
發表於 2019-6-21 02:01 AM|顯示全部樓層
如果發覺自己無法使用一些功能或出現問題,請按重新整理一次,並待所有網頁內容完全載入後5秒才進行操作。
我的習慣是沒寫文件的通通電爆,
不適合新人使用就是了。

上面有人提到了一些問題,但事實上問題在主管身上啊,
最好是主管不會去管這些,不要遇到一個廢物主管就以為所有主管都是廢物。
(頂多台灣有七八成是這種的,那就要怪你自已為什麼找不到、進不去那其他二三成的公司)

使用道具檢舉

您需要登錄後才可以回帖 登錄 | 註冊

Powered by Discuz!

© Comsenz Inc.

重要聲明:本討論區是以即時上載留言的方式運作,對所有留言的真實性、完整性及立場等,不負任何法律責任。而一切留言之言論只代表留言者個人意見,並非本網站之立場,用戶不應信賴內容,並應自行判斷內容之真實性。於有關情形下,用戶應尋求專業意見(如涉及醫療、法律或投資等問題)。 由於本討論區受到「即時上載留言」運作方式所規限,故不能完全監察所有留言,若讀者發現有留言出現問題,請聯絡我們。有權刪除任何留言及拒絕任何人士上載留言,同時亦有不刪除留言的權利。切勿撰寫粗言穢語、誹謗、渲染色情暴力或人身攻擊的言論,敬請自律。本網站保留一切法律權利。
回頂部