博客园  :: 首页  :: 新随笔  :: 联系 :: 订阅 订阅  :: 管理

《程序员》二月刊摘录

Posted on 2010-02-26 20:47  cshao  阅读(253)  评论(0编辑  收藏  举报

1. Iomega的v.Clone虚拟化克隆软件

    可以将一台物理机制作成VMware的虚拟镜像。上Iomega的官方网站看了一下,遗憾的是只有拥有了Iomega的移动硬盘等存储设备方可使用该软件。

 

2. 《漫谈技术写作》--蔡学镛

    应该在一开始就规划要具备哪些文档,并将这些文档当作成果验收的一部分。如果不这么做,文档最终一定会因为项目时间紧张而被牺牲掉。

    文档的品质比数量更重要。

    文档工程师(Technical Writer)--应当具有将技术概念视觉化的能力。

    技术文档的词汇选择应严谨。下列词汇在使用时要特别注意:必须、应该、可以、可能、最好、一定、经常、绝不等等

    技术文档最好不要使用太多字体,内容一般使用细明体(中文)搭配Times New Roman(英文)。程序码一律使用Courier New字体。中文字绝对不可以使用斜体。

    不要在文中描述到颜色,例如:图中蓝色部分是...

    多用项目分栏符号,以凸显重点。

    多用示意图和表格。

    用边框栏隔离短暂分岔的主题。包括:警告、历史缘由、强调等。不同的边框栏可以使用不同的图标。

    少用哲学、比喻,毕竟每个人的理解能力差异很大。