还是个学生的我问下各位上班族,在单位写这样注释真的大丈夫吗 - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
syahd
V2EX    问与答

还是个学生的我问下各位上班族,在单位写这样注释真的大丈夫吗

  •  
  •   syahd 2016-09-17 20:39:41 +08:00 4231 次点击
    这是一个创建于 3314 天前的主题,其中的信息可能已经有所发展或是发生改变。

    图片来自这个网址: https://lvyou.baidu.com/haishenmiao?innerfr_pg=destinationDetailPg&accur_thirdpar=destination
    http://i1.piimg.com/1949/c6125c947d2d1c70.png
    在注释里这么随便不要紧吗?我原本以为百度是一个很严谨的公司的

    23 条回复    2016-09-18 14:11:49 +08:00
    TheCure
        1
    TheCure  
       2016-09-17 20:40:45 +08:00
    百度还有这个业务啊...
    sourcebace
        2
    sourcebace  
       2016-09-17 20:51:31 +08:00 via iPhone
    正常啊,大厂有些代码也这样
    sourcebace
        3
    sourcebace  
       2016-09-17 20:52:13 +08:00 via iPhone
    不仅是百度……
    nicevar
        4
    nicevar  
       2016-09-17 21:03:04 +08:00 via iPhone
    没什么稀奇的,死板的人会看不过去
    iiduce
        5
    iiduce  
       2016-09-17 21:07:58 +08:00
    take it easy.
    lyragosa
        6
    lyragosa  
       2016-09-17 21:21:00 +08:00
    这种程度的话,个人认为没什么问题
    allenforrest
        span class="no">7
    allenforrest  
       2016-09-17 21:25:31 +08:00   6
    年轻的时候我经常喜欢在代码里写超级冗长的注释,甚至远超过代码长度。
    其实没有为什么,我希望后来的人,通过它能看到我的灵魂。
    tony1016
        8
    tony1016  
       2016-09-17 21:59:04 +08:00
    对程序员好一些,否则说不定又被 HR 盯上要开除了
    viko16
        9
    viko16  
       2016-09-17 21:59:38 +08:00
    证明没有 review ?
    a87150
        10
    a87150  
       2016-09-17 22:08:29 +08:00   1
    俊哥是谁?
    syahd
        11
    syahd  
    OP
       2016-09-17 22:13:43 +08:00 via Android
    @nicevar 那我就放心了啦,原来真正的公司比我想得还是开放
    jadecoder
        12
    jadecoder  
       2016-09-17 22:16:44 +08:00   3
    我有的时候会写这是哪个 PM 提的傻逼需求,希望时间会证明我是对的......


    其实最后都是我自己把代码改回去的,并没有后来者感叹这位前辈眼光犀利
    bugmenein
        13
    bugmenein  
       2016-09-17 22:46:57 +08:00
    内容可以忍受,但是不能忍受句子本身存在的过分口语化倾向,以及(可能是随之而来的)标点及语法问题。
    无论其内容如何,注释在形式上应该遵守一定的结构及表述规范(在大多数情况下,是指文法“标准”)。
    9avalon
        14
    9avalon  
       2016-09-18 00:34:16 +0800 via Android
    这说明代码没有 review
    Phariel
        15
    Phariel  
       2016-09-18 05:31:37 +08:00 via Android
    代码盲提交也是 而且也没打包压缩 uglify 的时候会将所有注释清除
    maplerecall
        16
    maplerecall  
       2016-09-18 06:52:16 +08:00 via Android
    问题不大,我才不会说我会在 HTML 注释里放字符画 doge 之类的东西…
    vivianalive
        17
    vivianalive  
       2016-09-18 07:27:05 +08:00
    我会在代码里 at 我自己,告诉大家,这个坑是我挖的。 ~ ~!
    msg7086
        18
    msg7086  
       2016-09-18 07:48:26 +08:00
    你一定没看过我司的代码。

    f = File.open("#{$in_path}") # Open a file
    xmlin = f.read # Read its contents as text
    f.close
    hanzichi
        19
    hanzichi  
       2016-09-18 08:44:52 +08:00
    无所谓吧,功能能实现就行了,有的代码连 console 都不注释掉 ...
    shakoon
        20
    shakoon  
       2016-09-18 08:51:04 +08:00
    哈哈哈哈哈,其实这是人家的企业文化呢
    watzds
        21
    watzds  
       2016-09-18 09:20:48 +08:00 via Android
    边缘业务,随便写
    murmur
        22
    murmur  
       2016-09-18 09:32:19 +08:00
    注释无所谓 问题是没 uglify 就上来这不好
    bk201
        23
    bk201  
       2016-09-18 14:11:49 +08:00 via iPhone
    只要不是生成文档的都可以.
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     5160 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 27ms UTC 09:34 PVG 17:34 LAX 02:34 JFK 05:34
    Do have faith in what you're doing.
    ubao snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86