找回密碼 或 安全提問
 註冊
|註冊|登錄

伊莉討論區

搜索
認識好友、聊天,分享生活趣事搞笑、娛樂、精彩的影片讓你看你準備好成為出色的版主了嗎?
三上出包王女259luxu銀魂中出中文惡靈古堡
孫炎cosx 068sone 112dasd6373d護身雜誌

休閒聊天興趣交流學術文化旅遊交流飲食交流家庭事務PC GAMETV GAME
熱門線上其他線上感情感性寵物交流家族門派動漫交流貼圖分享BL/GL
音樂世界影視娛樂女性頻道潮流資訊BT下載區GB下載區下載分享短片
電腦資訊數碼產品手機交流交易廣場網站事務長篇小說體育運動時事經濟
上班一族博彩娛樂

✡ 凡人修仙傳・123・

[繁]魔法光源股份有限

[繁]被逐出隊伍的治癒

[繁]再見龍生,你好人

[繁]魔法光源股份有限

[超清繁中]霹靂英雄戰
電腦新資訊電腦軟體討論電腦軟體資訊分享電腦硬體討論電腦硬體資訊分享電腦萌化版電腦系統 OS 討論電腦程式設計
電腦設計技術交流圖像設計及交流各類下載工具教學寬頻上網討論
查看: 74309|回復: 14
打印上一主題下一主題

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

Rank: 2Rank: 2

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

使用道具檢舉

帖子
0
積分
0 點
潛水值
10 米
頭香
發表於 2017-8-4 01:32 AM|只看該作者
若瀏覽伊莉的時侯發生問題或不正常情況,請使用Internet Explorer(I.E)。
台灣做事就是這樣
作文件要時間~你跟老闆或主管給你時間作規格或說明文件...
難啊...

使用道具檢舉

Rank: 1

帖子
922
積分
31 點
潛水值
17168 米
3
發表於 2017-11-25 02:44 PM|只看該作者
如果發覺自己無法使用一些功能或出現問題,請按重新整理一次,並待所有網頁內容完全載入後5秒才進行操作。
自己的公司也差不多
重要的系統沒詳細文件  只有應付的文書說明....
老闆能省則省 要做的事情娜麼多又不請人
誰想花時間去做文件?

使用道具檢舉

affkame 該用戶已被刪除
4
發表於 2018-10-27 10:48 PM|只看該作者
回覆中加入附件並不會使你增加積分,請使用主題方式發佈附件。
這問題其實多數的小公司都有,純粹是規模的問題而已,至於哪間比較好,適合的公司有適合的人

使用道具檢舉

  中學生(1000/4000)

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

Rank: 3Rank: 3Rank: 3

帖子
1092
積分
3387 點
潛水值
58453 米
5
發表於 2018-11-7 08:13 AM|只看該作者
如果瀏覽伊莉時速度太慢或無法連接,可以使用其他分流瀏覽伊莉,www01.eyny.com(02,03)。
主要還是要看老闆的觀念
只是一般很多公司文件是不算績效的
所以你花太多時間寫文件結果可能就是老闆覺得你沒績效

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





成為伊莉的版主,你將獲得更高級和無限的權限。把你感興趣的版面一步步地發展和豐盛,那種滿足感等著你來嚐嚐喔。

使用道具檢舉

Rank: 3Rank: 3Rank: 3

帖子
3471
積分
3977 點
潛水值
64610 米
6
發表於 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 嗎?而且是在很有可能每個人的文件寫作風格都有些不同的情況下(例如有些人用字不精準、或者用字太精準、或者用詞跟別人不同、.....)?
...
瀏覽完整內容,請先 註冊登入會員
如果你忘記伊莉的密碼,請在登入時按右邊出現的 '找回密碼'。輸入相關資料後送出,系統就會把密碼寄到你的E-Mail。

使用道具檢舉

帖子
31
積分
31 點
潛水值
520 米
7
發表於 2019-1-3 08:58 AM|只看該作者
所有積分大於負-100的壞孩子,將可獲得重新機會成為懲罰生,權限跟幼兒生一樣。
不意外,可以先將部分的程式碼看過一次之後再盡量用自己的方法配合,另外註解多加一點自成格式,這是我的建議
若新密碼無法使用,可能是數據未更新。請使用舊密碼看看。

使用道具檢舉

Rank: 1

帖子
65
積分
56 點
潛水值
15365 米
8
發表於 2019-1-22 05:20 PM|只看該作者
分享使你變得更實在,可以使其他人感到快樂,分享是我們的動力。今天就來分享你的資訊、圖片或檔案吧。
前輩或主管手上應該會有文件吧 不然只能自己摸索了

使用道具檢舉

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

帖子
6537
積分
4649 點
潛水值
95564 米
9
發表於 2019-3-19 01:05 PM|只看該作者
最好是你的客戶要求 api 文件...

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

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

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

我們公司用 doxygen... 來寫文件... 不知道適不適用...
分享使你變得更實在,可以使其他人感到快樂,分享是我們的動力。今天就來分享你的資訊、圖片或檔案吧。

使用道具檢舉

帖子
372
積分
21 點
潛水值
5911 米
10
發表於 2019-4-15 09:49 AM|只看該作者
如果瀏覽伊莉時速度太慢或無法連接,可以使用其他分流瀏覽伊莉,www01.eyny.com(02,03)。
kikuras 說的是,通常老闆都只給程式開發時間,沒有做文件時間
如果你是賣api的,老闆才會給你時間寫,因為客戶要。




若新密碼無法使用,可能是數據未更新。請使用舊密碼看看。

使用道具檢舉

Rank: 1

帖子
59
積分
185 點
潛水值
9771 米
11
發表於 2019-6-21 02:01 AM|只看該作者
我的習慣是沒寫文件的通通電爆,
不適合新人使用就是了。

上面有人提到了一些問題,但事實上問題在主管身上啊,
最好是主管不會去管這些,不要遇到一個廢物主管就以為所有主管都是廢物。
(頂多台灣有七八成是這種的,那就要怪你自已為什麼找不到、進不去那其他二三成的公司)
回覆中加入附件並不會使你增加積分,請使用主題方式發佈附件。

使用道具檢舉

Rank: 1

帖子
332
積分
31 點
潛水值
23164 米
12
發表於 2019-8-15 11:18 AM|只看該作者
如果你忘記伊莉的密碼,請在登入時按右邊出現的 '找回密碼'。輸入相關資料後送出,系統就會把密碼寄到你的E-Mail。
這很正常,完全不意外,也沒什麼
台灣的工作環境就是
老闆要求都是快
相對的下面能省事就省事
若瀏覽伊莉的時侯發生問題或不正常情況,請使用Internet Explorer(I.E)。

使用道具檢舉

Rank: 1

帖子
48
積分
59 點
潛水值
5080 米
13
發表於 2020-1-19 10:09 PM|只看該作者
看老闆給你多少時間
你就做多少事情
真的沒事做再來寫吧

使用道具檢舉

Rank: 2Rank: 2

帖子
1195
積分
476 點
潛水值
16530 米
14
發表於 2020-2-21 11:41 AM|只看該作者
一是沒有人在規劃這些事, 說白了這是主管的工作, 或者這是主管要分配的工作

就算function寫了說明,一個系統架構本身就不小,誰會吃飽沒事花時間去看funciton.

因為這種工對外沒有績效, 所以才需要某些機制(平台,軟體)讓大家知道自己團隊的每個人都在做什麼

要做的事情列出來, team的人自己認領,又或者指派, 建立KPI. 這樣才能變成一個良好的循環.
...
瀏覽完整內容,請先 註冊登入會員

使用道具檢舉

帖子
17
積分
1 點
潛水值
380 米
15
發表於 2020-7-25 01:28 PM|只看該作者
技術不困難~卻有很多人都想暗蓋技術~台灣或ˋ只要是人都這樣的ˊ




使用道具檢舉

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

Powered by Discuz!

© Comsenz Inc.

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