Seven Rules for Sound Documentation

写出好文档的7个原则。感觉对写论文也很有参考价值，因而贴出来。文章内容摘自"Documenting Software Architectures: Views and Beyond"。先写下来，以后慢慢添加自己的理解。
1.Write Documentation from the Reader’s Point of View
站在用户的角度写文档
2.Avoid Unnecessary Repetition
避免不必要的重复
3.Avoid Ambiguity
避免二义性
4.Use a Standard Organization
使用标准化组织结构
5.Record Rationale
记录某个决定的时候，应该同时记录拒绝其他选择的理由
6.Keep Documentation Current, But Not Too Current
时常更新文档，但不要更新的太频繁
7.Review Documentation for Fitness of Purpose
经常改进文档使之更加实用

酷我行

有次聊天，聊着聊着突然来一句“你们学校的创业风气还那么浓厚吗”？听着我一愣神，回想一下好像真是：周围一圈人，扳着指头数数总能找出那么几位“开公司”的；系里面找回来做讲座的成功人士，也多是“老板”级别的；刚进实验室的时候就听说当年毕业的一位师兄创业开公司，顺带卖掉渣饼。不过对这群人感觉还是很遥远，这次能去一家刚创立两年左右的公司参观，也算是一次难得的机会。
开始是两位创始人向介绍公司背景和创业理念，CEO雷鸣原是北大计算机硕士，毕业之后因为天网与百度的关系，直接进入当时还默默无闻的百度，一度担任首席架构师，与Google之间的较量是他最津津乐道的话题，工作一段之后决定去Stanford读MBA；COO怀奇本科毕业于上交管理专业，进入管理咨讯行业工作了三年之后出国读书。两人是同班同学，学成之后决定回国创业。公司目前规模在四十人左右，主要产品是基于互联网搜索的音乐软件。
在国外呆久了，看得多了，就有了前进的动力。对中国的发展前景充满信心，相信在今后十到二十年之内会出现中国自己的国际品牌。而这种公司出现在私企中的可能性最大。公司的投资者主要是风险投资商（VC），如何处理与VC之间的关系也是一个关键的问题。相当多数创业失败都是由于资金链的断裂：一个月发不出工资再忠诚的员工也受不了。但VC的目的是简单的期望投资迅速得到回报，然后抽资走人。在VC的短期利益要求与公司长远的愿景产生矛盾时如何处理也是个问题。他对目前的VC很满意，组成里既有资本雄厚的金融大鳄，业界大佬，也有与银行和政府关系深厚的；投资都具有长远眼光，不急于收回投资。
又问了几个版权的问题，就进入二阶段与员工交流。公司员工大多毕业于清北航邮等名牌院校。问题除了技术细节之外，大家最关心的两个问题一个是当初毕业时为什么作出这样的选择；一个是公司的盈利模式是什么。对第一个问题软件所一数学博士的回答挺有代表性的，他一毕业就进入这家公司，因为在与创始人交流之后觉得很受触动，相信他是很好的领导人，跟着他能取得成功。与进入大公司当coder相比，进入这样的小公司更能实现自身价值。其他人的观点也类似，认为这是高风险高回报的选择，一旦成功收益是巨大的，即使失败年轻也承受得起。对盈利模式问题，他们认为目前的主要问题是把产品做好，提高装机数，这也是公司由上至下的共识。
总体感觉在创始人的鼓舞下，公司上下都很有激情，内部氛围也很平等，员工领导之间直接姓名相称。展示的照片里面的大家的表情都很轻松愉悦，下楼的时候碰到几个员工去健身和打乒乓球，也是公司办的。
附带一提，有一个感觉从去年开始，接连几个事情，到现在越来越强烈：越来越多的东西，以前想都没有想到的，或即使想到了但是认为做不出来的现在都已经有产品了——技术的发展令人瞠目！有兴趣的不妨上网搜一下财富近几年评出的“酷公司”，看过之后相比也会有一些不一样的想法。

某人要我随便说说，那我就随便说说

如果说生活5%是快乐，5%是悲伤，剩下的90%都是平淡，那我现在正处在90%的区间中。如果把整个学期看作长跑，开学是起点，期末是重点，哪我现在就处在途中跑阶段：远离起点，也看不到终点。
生活就是处于这种平平淡淡、按部就班中：书照看，程序也照改，就如同体育馆边新建的那个游泳馆一样，虽然每天都在建，可从外面看不出一点变化。
变化同样发生在其他人身上，群里由开学初的热闹到现在的隔天几句话。见面谈起来都围绕一个忙字。真要说忙些个什么，也说不上来。每周六上完网络实验就开始忙，周日准备预习报告，周一一个上午的实验，周二三都有课，都忙完一周就过半了。缓两天又开始一个新的循环。实验室这边的任务穿插在期间做，锻炼挤时间做，其他抽时间做。
生活作息是晚上十二点睡，第二天九点左右起，中午经常还回去眯一会。每天的睡眠时间将近十小时，比小学生还充足！可还是老感觉困，不由感叹做学问没有特殊的体质还真是不行——每天睡六七个小时跟睡十个小时那差距可是天上地下哪。
拉拉杂杂说了那么大一通，老了老了。某人！你满意了么？

blog添加阅读全文功能

经过研究，终于明白如何在长文章中增加“阅读全文”的功能，不会像以前那样长长的一眼望不到尽头，大家只要通过摘要选择自己有兴趣的文章进行阅读即可。这样就不会出现以前那样资料类文章一写一大摞，感兴趣的人也不多，长长的一条放那里也碍眼。顺便对以前的文章也进行了一下梳理。Blogger的一个特点就是灵活性非常高，用户可以直接对网页代码进行修改。周边提供的插件也很多，看看里面的好东西还真不少，好好研究研究用起来。
修改方法参见：http://bloooooooogger.blogspot.com/2006/09/blogger-beta-hackbeta.html
注意选中“扩展窗口小部件模板”选项。

第一次汇报贴

从上次说要锻炼身体到现在已经两个月了，是时候汇报一下自己的进度，总结一下成果了。没有兴趣的就不要看啦。
先贴一下四月底做的一个身体素质测试的结果：
身高体重比 5（标准）
握力 30kg左右 （偏低）
弹跳 42cm （偏低）
柔韧性 1.3cm （较差）
肺活量 6500ml （不错）
脂肪含量 18.6%（正常15%，24%以下都可以接受）
因为腕子扭伤了，所以没有测俯卧撑。可以看到基本上与自己的估计是差不多的：上肢力量比较欠缺，柔韧性较差。
说到锻炼，同样是因为腕子的问题，所以四月下旬到现在基本上没怎么训练了。值得一提的是五一期间学会了游泳——完全的自学成才，慢慢摸索，现在已经能够哼哧哼哧地游完一个泳道了，当然姿势还很不标准。
另：火箭在今天的生死战中99-103负于爵士，黯然出局。小概率事件竟然在同一个球队身上连续发生两次！真不知说什么了。五一开了个好头，可却有这么个结尾，梦幻般的赛季啊……