北京 b 开头某大厂边缘部门你们能好好写文档吗

讨论 未结 14 53
3kkkk
3kkkk 会员 2022年5月14日 14:25 发表
收藏(0)  分享
相关标签: 灌水交流
注意:本文归作者所有,未经作者允许,不得转载
14个回复
  • Axnir
    2022年5月14日 14:25
    baidu 还是 bytedance 呢
    0 0
  • fengjianxinghun
    2022年5月14日 14:25
    ```类型是 array 描述给的是 hash 示例``` 是不是 php 写的?
    0 0
  • 3kkkk
    2022年5月14日 14:25
    👍👍👍我去看了下 php 语法还真是这样。应该是 php 写的。
    0 0
  • gam2046
    2022年5月14日 14:55
    文档这个吧,我发现多数大厂的文档还不如一些开源项目。国内商业公司,我接触过文档写的最好的是支付宝,其他就都那样了,至于比烂呢,大概就是微信了,这个体量和这个文档质量,一言难尽。 国外拿得出手的是微软,其次是 Google 的一些热门项目( Android 一类),相对不那么热门的项目文档已经很鸡毛了。 但是我自己也作为开发人员,写文档,特别是针对用户的文档,写起来比写代码还费时间。而且随着产品迭代,很容易忽略文档的更新。
    0 0
  • mysunshinedreams
    2022年5月14日 15:25
    最奇葩的是,某大厂开发前追着你要接口文档,开发的时候根本不按接口文档开发。
    0 0
  • panlatent
    2022年5月14日 15:55
    PHP 只有一个数据结构就是 array ,不经转换直接输出的话就输出各式各样的东西,比如说数组、对象( HASH/map/字典) ,值的类型也可能会变 比如 字符串数字和整数, 有时 null 还会夹杂其中。 好点的做法是做一层输出转换,有些 php 库专门干这个,但最好的方法还是限制住类型。
    0 0
  • 3kkkk
    2022年5月14日 16:57
    返参业务数据日期直接 string,描述也不写格式,鬼才能解的开。
    0 0
  • ufan0
    2022年5月14日 17:24
    杭州某大厂,其重量商业级产品文档都是错的,比如 yuque 、SofaBoot Stack ,提 Issue 后回复我让我自己贡献 PR ,如果是错别字什么的我就提交了,但是那是缺少内容甚至是内容错误啊,就离谱。
    0 0
  • panlatent
    2022年5月14日 17:54
    日期格式除了时间戳之外不就是字符串了么? 字符串的话只要是标准我还都能接受,有一些可能没加市区,一般默认北京时间,但是见过不少本身业务带时区的不加或者与 0 时区转换出的 bug
    0 0
  • LxExExl
    2022年5月14日 19:54
    直接说公司名会被查水表吗? 为啥要某某 abc 开头这么说呢?
    0 0
  • coolmenu
    2022年5月14日 22:54
    要开发文档是他们拖延工作的一部分,开发的时候,估计扔给外包或者新人小弟就不管了。
    0 0