关于和同组的人沟通的一些“术语”问题

最近新进一个偏business的组（背景: 这个组是做数据分析用了一些ML的东西。 以前只做一些基本的prototype用的是Python, pandas etc，具体有对应的开发组support；现在因为reorg这个组要开始接手开发的工作。下面简称我现在的team是“本组”， 我们对应的开发组是"开发组"）


进去之后开始工作的第一周，我看了一下code base，非常复杂。他们expect我光看code base就能知道code哪里有问题、以及code和对应系统的performance bottleneck在哪里---> 第一个问题来了，我承认我功底一般，刚开始工作，但是光看code base的话有没有什么技巧? 没有input data的schema、没有output的expected 结果， 只能硬抗，我没看出来逻辑和performance 问题。


于是我找组内人要"Technical design document". 不知道他们是不懂还是怎么，说没有这个东西。 我说那么如果我们交付于开发组，肯定有一个“类似于文档的东西，由我们阐述逻辑、对方根据这个逻辑开发”，对方也应该有个“类似文档记录开发的设计、每个function和class的输入输出以及计算逻辑”吧？  组里组员还是说“没有这个东西，你看看code base”


我以为是我的用词有理解的gap，所以我就更直白的说，开发组写的代码起码有一些test case来辅助function和class的逻辑确认的，有没有这些test case，回复很模糊：一会说UAT不归我们组管，一会说我们的test叫pytest （我有点confuse... pytest难道不是一种针对Python开发的测试工具的统称，就和我们说用Visual Studio开发，用version control控制版本etc同等的语义低位么? ）


anyway... 我就想问一下 是不是这个沟通的过程中，我用了不是state-of-art开发的一些词语，比如我说“business design document” 这些是不是不用的？
business业务逻辑文档叫什么，开发的文档叫什么？


谢谢！



补充内容 (2018-3-1 00:06):
今天硬是从开发组要文档 对方给了一个“Technical Documentation” 是我们code base内容的简要summary 。。。

2011051305 发表于 2018-3-1 00:16
我要是懒 我就混日子了 连问都不问好么。。。

难道不懒就是硬看code base。。。

我说懒是说开发的人...

我自己写完了code也没多大动力去写一份完整的doc给别人.

有bug修就修几个bug熟悉下code.

挺正常的....懒的都这样.

你问我为啥知道的，我入职时候也期待别人给我来一份跟java api一样的玩意...

ykwwind 发表于 2018-3-1 00:15
挺正常的....懒的都这样.

你问我为啥知道的，我入职时候也期待别人给我来一份跟java api一样的玩意...

我要是懒 我就混日子了 连问都不问好么。。。

难道不懒就是硬看code base。。。

这时候楼下感觉有人要劝退
不对……劝刷了。

我当时进一个C/C++/Java组也是类似这样，看不懂代码

后来换了一个组就好了。文档，Sprint，代码什么都很清楚。

ykwwind 发表于 2018-3-1 00:18
我说懒是说开发的人...

我自己写完了code也没多大动力去写一份完整的doc给别人.

soga。。。。我错了 sorry...

现在的问题其实是 我们组开发人员很少  reorg之后没有对应开发组，东西都得自己开发。
我suppose是扔给我一堆文档，然后强力支持我去联系开发组要各种test文档、design文档，并不是。。。。 我们组都无所谓的样子 真是醉了。。。那以后没有开发组了 咋办。。。

不理解。。。

很多组都没文档的...当然前提代码写的整洁就行. 建议楼主从头到尾复现一个小project, 就能大概了解code base里都是干什么的. 之后再抓着细节看看.

从来都没有doc，要学习读代码 跑一遍就看懂了

问下楼主是哪家公司呀，高盛？