V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
V2EX 提问指南
jiyinyiyong
V2EX  ›  问与答

有没有同学在做技术文档博客整理方面的想法?

  •  
  •   jiyinyiyong · 2013-06-12 11:52:50 +08:00 · 2279 次点击
    这是一个创建于 3972 天前的主题,其中的信息可能已经有所发展或是发生改变。
    技术方面的问题, 遇到了就是 Google, 找到有用的资源, 直接用对应的命令
    这里命令行好处明显, 直接复制粘贴, 不用图形界面那样手动操作, 马上能搞定
    简单概括这种方式是, 遇到问题, 从已有的资源检索方案, 找到直接照搬应用
    比如 StackOverflow, 已有的问题在上边, 遇到相同问题, 搜索到, 第一条答案照做
    人们也会期待遇到问题能直接使用已有的方案, 而不用加半点考虑
    这样就是技术问答和 Wiki 之类文档最为有效的作用

    我想说的相对琐碎些, 我们常常学点东西, 记在博客方便下次查阅
    分享的目的是其次, 重要的是下次遇到相同问题, 是继续 Google 还是直接上
    我渐渐也感到了花时间将重复任务整理成机器完成的脚本多么重要
    从开始学东西也尝试去记些博客.. 只是总觉得断断续续做不好

    我注意到几个问题:


    * 没有足够方便的网站来记录, 现成的博客网站都不会为技术的人弄很好的工具
    一方面是代码标记, 其次是博文的管理和评论的管理
    还有页面样式设计和其他一些技术宅容易挑剔的细节
    最终或者 Github 上弄页面, 或者技术强的同学自己实现一遍个人博客
    好多人都在重复地学习着 Jekyll 怎么用, Markdown 怎么用..
    没有那么多精力放在自己喜欢的技术上边有没有
    也有同学用别的工具来笔记, 相对就私人多了


    * Google 一下就发现文档各种重复, 第一条未必最好
    已经处理过的问题, 习惯上不喜欢 Google 去漫天找对吧
    一个人接触的技术有限, 希望看别人的笔记, 但是就感觉不那么容易
    如果我们是把文档收集在一起, 一起管理和修补, 像 Wiki, 就容易多了


    * 查找文档最想要的是速度, 而且解决问题别遇到子问题
    也许指望技术问题通常能一次性解决真的很难变成现实.. 当成美好的幻想吧
    我只是想, 如果我没有很多有人维护的文档, 解决问题就能快很多很多
    比起遇到了在 Google 海找, 每个新人重新找一次.. 多头疼


    学技术这么久, 一直就期待要不要找个师傅带一下, 避免那么多坑
    慢慢明白过来, 感兴趣的那么乱七八糟方面东西, 哪有一个人能都带..
    自己有点积累, 有新手来问, 发现教人真**烦, 特别是没基础上来就问
    就算努力想找办法能里坑远一点, 人们都把时间花在解决主要问题上, 好难

    所以就在想, 有没有同学在做这方面的工作, 去解决这类的问题
    比如说博客平台什么, 为了大家分享和维护技术方面的知识, 减少重复的消耗?
    主要是想知道..
    1 条回复    1970-01-01 08:00:00 +08:00
    airwalker
        1
    airwalker  
       2013-06-12 22:15:01 +08:00   ❤️ 1
    忽然想到Qiita,不曉得算不算。

    介绍: http://ruby-china.org/topics/7004
    关于   ·   帮助文档   ·   博客   ·   API   ·   FAQ   ·   我们的愿景   ·   实用小工具   ·   2677 人在线   最高记录 6543   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 24ms · UTC 10:37 · PVG 18:37 · LAX 03:37 · JFK 06:37
    Developed with CodeLauncher
    ♥ Do have faith in what you're doing.