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

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

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

我注意到几个问题:


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


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


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


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

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

介绍: http://ruby-china.org/topics/7004

这是一个专为移动设备优化的页面(即为了让你能够在 Google 搜索结果里秒开这个页面),如果你希望参与 V2EX 社区的讨论,你可以继续到 V2EX 上打开本讨论主题的完整版本。

https://www.v2ex.com/t/72115

V2EX 是创意工作者们的社区,是一个分享自己正在做的有趣事物、交流想法,可以遇见新朋友甚至新机会的地方。

V2EX is a community of developers, designers and creative people.

© 2021 V2EX