你会在 coding 之前先用足够多的文档理清思路么? - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
Livid
55.22D
447.11D
V2EX    问与答

你会在 coding 之前先用足够多的文档理清思路么?

  •  
  •   Livid
    PRO
    2013-02-17 19:08:01 +08:00 via iPhone 5501 次点击
    这是一个创建于 4621 天前的主题,其中的信息可能已经有所发展或是发生改变。
    24 条回复    1970-01-01 08:00:00 +08:00
    aveline
        1
    aveline  
       2013-02-17 19:13:10 +08:00
    复杂度高的时候会,简单的就直接上手了。
    reorx
        2
    reorx  
       2013-02-17 19:47:28 +08:00
    一开始可能不需要,凭着一点灵思就做起来了,但往往在进行了一个阶段后发现效率降低,这时候就需要先写一些文档,整理下思路,再列好任务清单,一项一项来,免得不知不觉犯了并行多个任务的弊病。
    subpo
        3
    subpo  
    PRO
       2013-02-17 19:49:28 +08:00
    至少用个todo,不然做不起来
    kedron
        4
    kedron  
       2013-02-17 20:11:30 +08:00
    用MindNode画脑图。
    Kai
        5
    Kai  
       2013-02-17 20:23:28 +08:00
    我会先列出自己拿不准的点,然后逐个考察。这样整理一遍,基本上心里就有数了,然后开始。
    Cofyc
        6
    Cofyc  
       2013-02-17 20:33:40 +08:00
    写之前整理好思路大多时候有点困难,一般是边写边整理。
    zhy0216
        7
    zhy0216  
       2013-02-17 20:36:50 +08:00
    我一般先画个ER图...
    vicalloy
        8
    vicalloy  
       2013-02-17 21:28:01 +08:00
    只会做个大致规划和方案,评估一下可行性。
    把主要问题点的大致方案做出来,保证不会中途卡壳。
    接下来基本上边做边整理。
    chloerei
        9
    chloerei  
       2013-02-17 21:29:44 +08:00
    用纸画很多草稿。
    kaiix
        10
    kaiix  
       2013-02-17 21:40:24 +08:00
    1.找难点 2.阅读资料和开源代码 3.写demo 4.列任务 5.具体实现
    根据目标难度可从1开始 或者从4,5开始

    P.S. @Livid 这里的文档具体指什么 是技术资料? 定义的阶段性目标? 还是其他?
    ytzong
        11
    ytzong  
       2013-02-17 21:56:00 +08:00
    不会,一切凭感觉
    SuperOS
        12
    SuperOS  
       2013-02-17 22:00:13 +08:00
    规划还是要先写的,详细文档跟代码同步完善,最后再整理
    sivacohan
        13
    sivacohan  
    PRO
       2013-02-17 22:02:19 +08:00
    如果是自己的项目,会在纸上写写画画。目的有两个:
    1、明确自己要做什么。
    2、冻结需求,保证自己不会因为对某个地方的忘我重构导致流产。(我很多东西都是这么流产的)

    如果是需要几个人合作的项目,我必然会好好写这个。目的:
    1、明确需求,解决的问题。这样才能给别人讲的时候条理清晰。
    2、易于分工。
    3、易于交流,当所有人对项目的认知统一的时候,交流的成本是最低的。
    4、保证项目不会没事乱改。
    sivacohan
        14
    sivacohan  
    PRO
       2013-02-17 22:03:05 +08:00
    哦,自己的项目如果中间有灵感了。会记在todo list上。以后再说。我不是靠谱的人,大多数灵感都不靠谱。
    yaotian
        15
    yaotian  
       2013-02-17 22:09:47 +08:00
    我的经验是先写comments, 这些comment实际上就是思路。
    然后再代码实现。

    我会用这样的格式。
    //== xxxxxx

    //== xxxxxx

    要看完整文档,就用grep == *

    当然这是说代码中的格式。

    其它的格式要符合各个项目的代码规范。
    hzlzh
        16
    hzlzh  
    PRO
       2013-02-17 23:11:16 +08:00
    我会把整个流程想清楚,然后把细节注意的地方记载下来备用(Clear App),也提前想好完成之后运维的条理东西,放到 Evernote 里,然后再开始搞。
    dreampuf
        17
    dreampuf  
       2013-02-18 00:02:12 +08:00
    尽可能的找相关资料,丢到一个地方。
    比较甄选方案
    自行开发
    记录troubleshooting

    导出文档,作为日后维护以及追溯
    dqaria
        18
    dqaria  
       2013-02-18 10:09:13 +08:00
    先确定一下具体功能和实现难点,开发时用Cucumber与Rspec进行BDD开发~Cucumber本身就可以作为文档使用~
    alexrezit
        19
    alexrezit  
       2013-02-18 10:18:51 +08:00 via iPhone
    不会, 会用图. MindNode, 但更喜欢用纸.
    ShadowStar
        20
    ShadowStar  
       2013-02-18 11:16:36 +08:00
    从来不写文档~~
    在脑子里设计好了就动手
    Narcissu5
        21
    Narcissu5  
       2013-02-18 11:52:35 +08:00
    TDD测试驱动,先写测试代码是理清思路的最好方法,也能有效的提高代码质量,就是比较费时间。
    master
        22
    master  
       2013-02-18 16:17:08 +08:00
    一般会随手抓写纸画一些图,做一些备忘吧
    hpyhacking
        23
    hpyhacking  
       2013-02-18 16:32:44 +08:00
    A4白纸少许 铅笔一只
    soolby
        24
    soolby  
       2013-02-18 16:39:46 +08:00
    文档不是PM都准备了吗~
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     3547 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 29ms UTC 05:03 PVG 13:03 LAX 22:03 JFK 01:03
    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