<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>冉翔 ~ At World&#039;s End &#187; work</title>
	<atom:link href="http://blog.ranxiang.com/tag/work/feed/" rel="self" type="application/rss+xml" />
	<link>http://blog.ranxiang.com</link>
	<description>He&#039;s Pirate.</description>
	<lastBuildDate>Sun, 25 Jul 2010 21:00:00 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.0.1</generator>
		<item>
		<title>FreeWheel 2010开放职位</title>
		<link>http://blog.ranxiang.com/2010/04/14/freewheel-2010-jobs/</link>
		<comments>http://blog.ranxiang.com/2010/04/14/freewheel-2010-jobs/#comments</comments>
		<pubDate>Wed, 14 Apr 2010 08:26:44 +0000</pubDate>
		<dc:creator>ranxiang</dc:creator>
				<category><![CDATA[未分类]]></category>
		<category><![CDATA[freewheel]]></category>
		<category><![CDATA[job]]></category>
		<category><![CDATA[work]]></category>

		<guid isPermaLink="false">http://blog.ranxiang.com/?p=367</guid>
		<description><![CDATA[如果你热爱技术， 如果你想了解，一次网络视频广告投放背后的秘密 如果你想了解，快速增长的视频广告市场和传统网络广告的区别 如果你想了解，支撑海量广告服务的服务器集群和系统架构 如果你想体验，国际化的产品开发和多元化的工作机遇 如果你在寻找互联网除搜索之外的下一个新兴舞台 现在就加入FreeWheel，和我们一起感受大规模互联网服务的巨大魅力，发挥你无限的创新潜能。 关于FreeWheel FreeWheel创建于2007年，总部位于美国硅谷，是一家专门提供互联网视频广告投放、监测、预测、增值等关键解决方案的外商独资公司。创始人是Douglas Knopper, Jon Heller和Diane Yu。FreeWheel由硅谷著名的风险投资机构 Battery Ventures投资，在中国北京设立产品研发中心。 FreeWheel创始人在美国网络广告界拥有多年市场、产品、技术方面的经验和来自DoubleClick，Yahoo！等知名公司的资深管理经验。 作为一家快速发展的硅谷IT创业公司，凭借准确的商业模式和产品定位，高效的技术研发，经过近三年的发展，产品上线并已为包括CBS，WarnerBrothers，Turner，MLB、Vevo、Discovery等知名客户提供服务，日均广告投放已超过上亿次，并仍在快速增长。公司员工也已增加至近100人，其中北京研发中心60余人，并在不断发展壮大。 北京研发中心目前担负FreeWheel全线产品的研发工作，包括B2B Web开发，Open API平台，高性能互联网在线广告服务器，海量日志处理，广告预测，视频前端整合等核心技术。在这里，你有机会和一流的工程师团队一起工作，参与跨国协作，并分享公司快速成长带来的职业发展机会。   FreeWheel工作机遇 FreeWheel一直以能够拥有最出色、最卓越的业内团队而引以为豪。FreeWheel深知人才的宝贵，因此特别重视优秀人才对技术创新和企业持续发展的价值。FreeWheel北京研发团队由60多名朝气蓬勃，才华横溢的年轻人组成，绝大部分毕业于清华、北大等国内知名学府。 公司的人才理念是：We are building a team of the best and brightest! 2010年FreeWheel开放职位： 职位名称1 Mobile Integration Software Engineer 移动应用软件工程师 工作地点：北京 简历发送至：jobs@freewheel.tv （在简历上注明应聘职位） 职位描述： * working with engineers from multiple teams/companies/continents * building libraries and]]></description>
			<content:encoded><![CDATA[
<div class="topsy_widget_data topsy_theme_blue" style="float: right;margin-left: 0.75em; background: url(data:,%7B%20%22url%22%3A%20%22http%253A%252F%252Fblog.ranxiang.com%252F2010%252F04%252F14%252Ffreewheel-2010-jobs%252F%22%2C%20%22style%22%3A%20%22big%22%2C%20%22title%22%3A%20%22FreeWheel%202010%E5%BC%80%E6%94%BE%E8%81%8C%E4%BD%8D%20%23freewheel%20%23job%20%23work%22%20%7D);"></div>
<p>如果你热爱技术，</p>
<p>如果你想了解，一次网络视频广告投放背后的秘密</p>
<p>如果你想了解，快速增长的视频广告市场和传统网络广告的区别</p>
<p>如果你想了解，支撑海量广告服务的服务器集群和系统架构</p>
<p>如果你想体验，国际化的产品开发和多元化的工作机遇</p>
<p>如果你在寻找互联网除搜索之外的下一个新兴舞台</p>
<p>现在就加入FreeWheel，和我们一起感受大规模互联网服务的巨大魅力，发挥你无限的创新潜能。</p>
<p><strong>关于</strong><strong>FreeWheel</strong></p>
<p>FreeWheel创建于2007年，总部位于美国硅谷，是一家专门提供互联网视频广告投放、监测、预测、增值等关键解决方案的外商独资公司。创始人是Douglas Knopper, Jon Heller和Diane Yu。FreeWheel由硅谷著名的风险投资机构 Battery Ventures投资，在中国北京设立产品研发中心。</p>
<p>FreeWheel创始人在美国网络广告界拥有多年市场、产品、技术方面的经验和来自DoubleClick，Yahoo！等知名公司的资深管理经验。 作为一家快速发展的硅谷IT创业公司，凭借准确的商业模式和产品定位，高效的技术研发，经过近三年的发展，产品上线并已为包括CBS，WarnerBrothers，Turner，MLB、Vevo、Discovery等知名客户提供服务，日均广告投放已超过上亿次，并仍在快速增长。公司员工也已增加至近100人，其中北京研发中心60余人，并在不断发展壮大。</p>
<p>北京研发中心目前担负FreeWheel全线产品的研发工作，包括B2B Web开发，Open API平台，高性能互联网在线广告服务器，海量日志处理，广告预测，视频前端整合等核心技术。在这里，你有机会和一流的工程师团队一起工作，参与跨国协作，并分享公司快速成长带来的职业发展机会。</p>
<p><strong> </strong></p>
<p><strong>FreeWheel</strong><strong>工作机遇</strong><strong></strong></p>
<p>FreeWheel一直以能够拥有最出色、最卓越的业内团队而引以为豪。FreeWheel深知人才的宝贵，因此特别重视优秀人才对技术创新和企业持续发展的价值。FreeWheel北京研发团队由60多名朝气蓬勃，才华横溢的年轻人组成，绝大部分毕业于清华、北大等国内知名学府。</p>
<p>公司的人才理念是：We are building a team of the best and brightest!</p>
<p><strong>2010</strong><strong>年</strong><strong>FreeWheel</strong><strong>开放职位：</strong><strong></strong></p>
<p><strong>职位名称</strong><strong>1</strong></p>
<p>Mobile Integration Software Engineer</p>
<p><span style="text-decoration: underline;">移动应用软件工程师</span></p>
<p>工作地点：北京</p>
<p>简历发送至：<a href="mailto:jobs@freewheel.tv">jobs@freewheel.tv</a> （在简历上注明应聘职位）</p>
<p>职位描述：</p>
<p>* working with engineers from multiple teams/companies/continents<br />
* building libraries and applications for cutting-edge mobile devices</p>
<p>职位需求：<br />
* C or C++ is a must<br />
* Excellent knowledge of ActionScript / HTML5 / Python is a plus<br />
* Experience with of Cocoa Touch / Android is plus<br />
* Proficient in speaking and writing English.</p>
<p><strong>职位名称</strong><strong>2</strong></p>
<p>Software Engineer</p>
<p><span style="text-decoration: underline;">软件工程师（网络应用软件系统开发部门）</span></p>
<p>(Sr.) Software Engineer</p>
<p><span style="text-decoration: underline;">（资深）软件工程师（网络应用软件系统开发部门）</span></p>
<p>工作地点：北京</p>
<p>简历发送至：<a href="mailto:jobs@freewheel.tv">jobs@freewheel.tv</a> （在简历上注明应聘职位）</p>
<p>职位描述：</p>
<p>* Responsible for building large-scale B2B web application;</p>
<p>* Making day-to-day tech decision to grow our global business.</p>
<p>职位需求：</p>
<p>* Strong hands-on large-scale web application or information system(ERP, Banking system, etc) development experiences;</p>
<p>* Solid knowledge on design patterns, OOD, OOP;</p>
<p>* Solid knowledge on Linux, network protocols, http servers;</p>
<p>* Strong hands-on web 2.0 user interface development experience, Ruby on Rails or PHP preferred</p>
<p>* Solid PL/SQL programming experience, MySQL or Oracle preferred</p>
<p>* Solid HTML, CSS, JavaScript, Ajax knowledge</p>
<p>* Strong reading and writing skills in English</p>
<p>* Bachelor’s or Master’s degree in Computer Science or related field</p>
<p>附加需求：</p>
<p>* Experience in C++/Java programming development;</p>
<p>* Experience in Component-Based Development is preferred;</p>
<p>* Experience in testing tools/frameworks such as CruiseControl, NUnit;</p>
<p>* Agile software development processes, such as SCRUM;</p>
<p>* Test driven development;</p>
<p>* Management skills is preferred.</p>
<p>我们希望你是</p>
<p>1. 具备扎实的计算机和软件技术背景，热爱技术工作。</p>
<p>2. 学习能力强，能够承担压力和技术挑战，非常认真细致。</p>
<p>3. 乐观开朗，热爱生活。</p>
<p><strong>请务必在简历上注明应聘职位，将简历发送至：</strong><strong><a href="mailto:job@freewheel.tv">jobs@freewheel.tv</a></strong></p>
<p>公司网站：<a href="http://www.freewheel.tv/">http://www.freewheel.tv</a></p>
<p><strong> </strong></p>
<p><strong> </strong></p>
<p>在FreeWheel我们能提供：</p>
<p><strong>1. </strong><strong>业内有竞争力的薪资福利</strong><strong></strong></p>
<p>l  富有竞争力的工资</p>
<p>我们根据员工的岗位性质以及所担负职责为员工提供业内富有竞争力的固定工资，并且我们会对表现持续优秀的员工提供每年至少一次的加薪机会。</p>
<p>l  股票期权</p>
<p>我们承诺FreeWheel每一位员工都享受公司的期权，旨在让所有员工能够分享公司业绩的增长以及发展，确保员工的个人利益与公司的长远利益紧密结合在一起。</p>
<p>l  完善的社保计划</p>
<p>全额为员工缴纳五险一金，提供完善的员工综合医疗保险以及员工子女的医疗保险</p>
<p>l  其他福利</p>
<p>我们为员工提供丰富的福利计划旨在为员工创造一个舒适和谐的工作环境，并实现工作生活的平衡。这些福利计划包括：丰富多彩的团队拓展活动、节日福利、带薪休假等等。</p>
<p><strong>2. </strong><strong>专业、丰富的技术、管理等培训，为员工提供广阔发展、晋升空间</strong><strong></strong></p>
<p>作为技术导向型公司，FreeWheel一直致力于为员工提供专业、前沿的业务和技术培训，使员工全面、深入的了解网络视频广告的尖端技术、系统的架构、研发以及应用。公司会创造多元化的学习环境，鼓励员工利用各种方式学习成长，通过不同的学习活动，提升个人职业能力，帮助员工在公司达成个人职业生涯的巅峰。</p>
<p><strong>3. </strong><strong>高水平的技术研发团队，一流的工作环境</strong><strong></strong></p>
<p>FreeWheel北京研发中心拥有专业技术工程师60多人，并在不断的发展壮大，他们绝大部分毕业于清华、北大等国内顶尖学府。我们的工程师是由具有多年从事网络开发、服务经验的高端人才组成。</p>
<p><strong>4. </strong><strong>英文工作环境，参与国际多元化协作</strong><strong></strong></p>
<p>FreeWheel总部位于美国硅谷，并在北京和纽约建立研发中心和数据运营中心，在这里能和世界一流的工程师一起工作，并有机会前往美国进行培训和工作，享受国际多元化的工作环境带给你无限的机遇和挑战。</p>
<p><strong> </strong></p>
<p><strong>Check the following links to know more about FreeWheel</strong></p>
<p>Co founder/CTO Diane Yu’s blog</p>
<p><a href="http://blog.dianeyu.com/">http://blog.dianeyu.com/</a></p>
<p>从Google收购DoubleClick谈起——我的追梦之旅</p>
<p><a href="http://blog.csdn.net/programmer_editor/archive/2008/04/09/2270807.aspx">http://blog.csdn.net/programmer_editor/archive/2008/04/09/2270807.aspx</a></p>
<p>回首十年——从程序员到CTO</p>
<p><a href="http://www.programmer.com.cn/351/">http://www.programmer.com.cn/351/</a></p>

]]></content:encoded>
			<wfw:commentRss>http://blog.ranxiang.com/2010/04/14/freewheel-2010-jobs/feed/</wfw:commentRss>
		<slash:comments>2</slash:comments>
		</item>
		<item>
		<title>两年</title>
		<link>http://blog.ranxiang.com/2009/10/21/%e4%b8%a4%e5%b9%b4/</link>
		<comments>http://blog.ranxiang.com/2009/10/21/%e4%b8%a4%e5%b9%b4/#comments</comments>
		<pubDate>Wed, 21 Oct 2009 03:06:33 +0000</pubDate>
		<dc:creator>ranxiang</dc:creator>
				<category><![CDATA[未分类]]></category>
		<category><![CDATA[freewheel]]></category>
		<category><![CDATA[work]]></category>
		<category><![CDATA[回顾]]></category>
		<category><![CDATA[工作]]></category>
		<category><![CDATA[总结]]></category>

		<guid isPermaLink="false">http://blog.ranxiang.com/?p=266</guid>
		<description><![CDATA[早上起来在看日期，发现今天正好是整整加入FreeWheel两周年。 两年过去了，FreeWheel已经成为我有史以来呆过最久的一家公司，我有信心继续创造纪录。因为理由与一年前一样。OMG, I LOVE US!!! 这一年收到了更多猎头的电话和邮件，最终还是都婉拒了。因为工作了4，5年才开始明白一时的薪水多少与职位高低并不是证明工作好坏的全部。还有一些东西甚至更重要一些，譬如工作的氛围环境，比如公司的前景与机遇。FreeWheel有着良好的前景，有着一群genius做同事，想想，都觉得很满足。 还有很多画面，总是值得记忆的，譬如： 公司两周年的时候在海边开篝火晚会，大家手拉手跳着舞，喝的醉醺醺的，跳的歪七扭八的，但你会觉得真的很美好。 每个月都会有一个大蛋糕给这个月生日的童鞋祝贺，看着大家边切，边吃，边聊，边笑的，你会觉得很快乐。 有时候新产品/版本上线的时候，看到项目组的同事废寝忘食，下了班继续在fix bug，以至于老板把签名改为&#8221;Hey&#8230;Try to leave office before 7pm, everybody!&#8221;。你会觉得很有爱。 这一年，工作任务有了些许变化，只写了很少的ruby code，却明白了更多BI，数据挖掘，数据库优化的东西。 参与了一个全新的项目，从中学到了太多太多。项目即将正式发布，希望一切顺利，因为它包含了每个人的汗水与劳动。 这一年，工作还打开了我的很多心结，比如对于沟通的认识，对于软件价值的判定，对于敏捷的思考，对于设计的想法。都开始有了很多答案。 开始学着从一个比较高的角度去看待问题，解决问题。心中谨记着Big Picture. 昨天看老爸的QQ的签名写着“拼了老命也要把公司做强做大。” 突然也很想把自己的签名改成“拼了小命……。” 嗯，希望自己来年能发挥更大的作用和价值，希望FreeWheel继续快快增长，健康成长哈。]]></description>
			<content:encoded><![CDATA[
<div class="topsy_widget_data topsy_theme_blue" style="float: right;margin-left: 0.75em; background: url(data:,%7B%20%22url%22%3A%20%22http%253A%252F%252Fblog.ranxiang.com%252F2009%252F10%252F21%252F%2525e4%2525b8%2525a4%2525e5%2525b9%2525b4%252F%22%2C%20%22style%22%3A%20%22big%22%2C%20%22title%22%3A%20%22%E4%B8%A4%E5%B9%B4%20%23freewheel%20%23work%20%23%E5%9B%9E%E9%A1%BE%20%23%E5%B7%A5%E4%BD%9C%20%23%E6%80%BB%E7%BB%93%22%20%7D);"></div>
<ol>
<li>早上起来在看日期，发现今天正好是整整加入<a href="http://www.freewheel.tv">FreeWheel</a>两周年。</li>
<li>两年过去了，FreeWheel已经成为我有史以来呆过最久的一家公司，我有信心继续创造纪录。因为理由与<a href="http://blog.ranxiang.com/2008/10/13/%E4%B8%80%E5%B9%B4/">一年</a>前一样。OMG, I LOVE US!!!</li>
<li>这一年收到了更多猎头的电话和邮件，最终还是都婉拒了。因为工作了4，5年才开始明白一时的薪水多少与职位高低并不是证明工作好坏的全部。还有一些东西甚至更重要一些，譬如工作的氛围环境，比如公司的前景与机遇。FreeWheel有着良好的前景，有着一群genius做同事，想想，都觉得很满足。</li>
<li>还有很多画面，总是值得记忆的，譬如：</li>
<li>公司两周年的时候在海边开篝火晚会，大家手拉手跳着舞，喝的醉醺醺的，跳的歪七扭八的，但你会觉得真的很美好。</li>
<li>每个月都会有一个大蛋糕给这个月生日的童鞋祝贺，看着大家边切，边吃，边聊，边笑的，你会觉得很快乐。</li>
<li>有时候新产品/版本上线的时候，看到项目组的同事废寝忘食，下了班继续在fix bug，以至于老板把签名改为&#8221;Hey&#8230;Try to leave office before 7pm, everybody!&#8221;。你会觉得很有爱。</li>
<li>这一年，工作任务有了些许变化，只写了很少的ruby code，却明白了更多BI，数据挖掘，数据库优化的东西。</li>
<li>参与了一个全新的项目，从中学到了太多太多。项目即将正式发布，希望一切顺利，因为它包含了每个人的汗水与劳动。</li>
<li>这一年，工作还打开了我的很多心结，比如对于沟通的认识，对于软件价值的判定，对于敏捷的思考，对于设计的想法。都开始有了很多答案。</li>
<li>开始学着从一个比较高的角度去看待问题，解决问题。心中谨记着Big Picture.</li>
<li>昨天看老爸的QQ的签名写着“拼了老命也要把公司做强做大。” 突然也很想把自己的签名改成“拼了小命……。”</li>
<li>嗯，希望自己来年能发挥更大的作用和价值，希望FreeWheel继续快快增长，健康成长哈。</li>
</ol>

]]></content:encoded>
			<wfw:commentRss>http://blog.ranxiang.com/2009/10/21/%e4%b8%a4%e5%b9%b4/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>说说项目中文档的那点事</title>
		<link>http://blog.ranxiang.com/2009/03/12/%e8%af%b4%e8%af%b4%e9%a1%b9%e7%9b%ae%e4%b8%ad%e6%96%87%e6%a1%a3%e7%9a%84%e9%82%a3%e7%82%b9%e4%ba%8b/</link>
		<comments>http://blog.ranxiang.com/2009/03/12/%e8%af%b4%e8%af%b4%e9%a1%b9%e7%9b%ae%e4%b8%ad%e6%96%87%e6%a1%a3%e7%9a%84%e9%82%a3%e7%82%b9%e4%ba%8b/#comments</comments>
		<pubDate>Thu, 12 Mar 2009 07:58:30 +0000</pubDate>
		<dc:creator>ranxiang</dc:creator>
				<category><![CDATA[未分类]]></category>
		<category><![CDATA[Agile]]></category>
		<category><![CDATA[cmm]]></category>
		<category><![CDATA[document]]></category>
		<category><![CDATA[work]]></category>
		<category><![CDATA[软件工程]]></category>

		<guid isPermaLink="false">http://blog.ranxiang.com/?p=64</guid>
		<description><![CDATA[尽量写具备自描述能力的代码。如果某些时候，必须要写文档才能解决问题的时候，记得随时更新它。使它和你的项目保持同步。]]></description>
			<content:encoded><![CDATA[
<div class="topsy_widget_data topsy_theme_blue" style="float: right;margin-left: 0.75em; background: url(data:,%7B%20%22url%22%3A%20%22http%253A%252F%252Fblog.ranxiang.com%252F2009%252F03%252F12%252F%2525e8%2525af%2525b4%2525e8%2525af%2525b4%2525e9%2525a1%2525b9%2525e7%25259b%2525ae%2525e4%2525b8%2525ad%2525e6%252596%252587%2525e6%2525a1%2525a3%2525e7%25259a%252584%2525e9%252582%2525a3%2525e7%252582%2525b9%2525e4%2525ba%25258b%252F%22%2C%20%22style%22%3A%20%22big%22%2C%20%22title%22%3A%20%22%E8%AF%B4%E8%AF%B4%E9%A1%B9%E7%9B%AE%E4%B8%AD%E6%96%87%E6%A1%A3%E7%9A%84%E9%82%A3%E7%82%B9%E4%BA%8B%20%23Agile%20%23cmm%20%23document%20%23work%20%23%E8%BD%AF%E4%BB%B6%E5%B7%A5%E7%A8%8B%22%20%7D);"></div>
<p>我觉得这篇写不长，因为其实关于文档的一些理念基本都是那种说着很简单，做着很难的。</p>
<p><strong>文档多了好？</strong></p>
<p>记得以前看CMM的时候，很强调文档的重要性。这是为什么咧？因为CMM是典型的软件工程理论嘛，而软件工程怎么来的咧？就是从建筑工程学来滴嘛。君不见，<span style="text-decoration: line-through;">黄河之水天上来</span>盖栋房子得有多少文档啊，来描述这个建筑的架构，每个房间的布局。这啊哪的，反正肯定很多就是了。都是设计师仔仔细细设计规划好弄好了，然后由俺们最可耐滴农民工一砖一瓦的，蹭蹭的，一栋building就出来了。所以CMM挺强调文档滴，整个软件周期，都要有这文档那文档的，堆积如山的。而实际效果呢？用猜的也知道肯定不怎么好了，不然现在人都表当自个Agile，而不说自个CMM了呢。</p>
<p>好吧，那你说这是为什么呢？我来告诉你。如果你建个大楼，建完之后你会没事拆着玩么？比如把18~20楼拆了，换个盖法。或者把楼里的钢筋全换一遍，换个回扣给的工作的牌子。你不会吧。所以你盖好之后，你那份文档描述的就是你的building，所以可以从下水道偷偷溜到你楼顶。所以这份文档是即使的反映了这个building的结构与状态的。</p>
<p>反过来，看软件开发。你能保证你写完之后的code有几天不被改？重写，重构，bug fix，需求变更。这些常见的活哪个不是要你改code。而你弄了那么多的文档，最后发现和code完全不一致了，那你说这效果能好么。文档说CLASS A是干这事的。结果一看code发现CLASS A根本就不是干那事的。当然，也可能你根本已经找不到CLASS A这么一个玩意儿了。</p>
<p>所以说文档足够多并不一定好，因为软件开发中，变化是从头到尾的。所以如果文档的变化跟不上项目的变化，太多的过时信息。最终非但不能帮助项目，却还会拖后腿，造成更多的怀疑，浪费经历。</p>
<p><strong>少就是多？</strong></p>
<p>爱扯Agile的肯定都说过这么一句话：代码即文档。</p>
<p>嗯，如果我没记错，好像这句应该是敏捷宣言中的？（刚查了下，原话和我记性不太一样，原话是：Working software over comprehensive documentation.）就是说如果你的代码写的足够好，本身就足够说明很多问题（比如通过起带有意义名字的变量，比如使用元数据编程，比如加恰当的注释）。那么就不需要和外在另外一个地方写场面大论来描述代码是怎么回事。</p>
<p>其实这方面我觉得很有代表性的就是javadoc和Xdoclet。javadoc也影响了很多后来的框架和语言啊。因为做的确实不错。通过在注视中加入一些符号，可以自动通过程序来抽象出注释，组成有意义的文档。这是多么automatic的事情。而且特别是你的注释和你的code在一起，就减少了很多两遍对不上，描述过时这类的事情。Xdoclet当然也是关于这方面的一个工具吧。</p>
<p>嗯，还有元数据以及DSL这种编程方式也在很大程度上为代码可读性做出了优秀的贡献。</p>
<p>比如Rails中，在Model之间声明关系用的belongs_to, has_many之类的关键字（当然，其实他们不算关键字，也是方法，只是表现形式cool了些）。是多么的简洁，有力，聪明，异动啊。</p>
<p>所以我基本上很赞成，因为大科学家爱因斯坦都说简洁性就是一种美。因为俺觉得懒惰的程序员才是好程序员。如果代码就够清楚的，或者通过代码就能生成出来很清楚的文档，那么鬼才写文档。当然，其实这观点是偏激的。因为我们确实需要文档。因为代码只能从微观角度看问题，即便你给我一个SDK文档，我还是很难看出你当初都是为什么这么设计，那么构造之类的。So，我们依然需要文档。但是要强调一定，我们需要的是高质量的文档，正确的文档。因为Diane说过：方向很重要（嗯，某次开大会说滴，很富哲理啊）。文档都是错了，就算你看个三天三夜，你也只能越看越错下去。所以，文档只有在正确的时候，才具有很大的重要性。如果只是过时的玩意儿，那么不如放到回收站吧。</p>
<p><strong>The End</strong></p>
<p>到现在，观念应该清楚了，文档其实还是需要的，但是我们如何去写文档呢？怎么使得文档是正确，有重大价值的呢？</p>
<p>嗯，我又发明了一个小所写KISSS原则。全称是：Keep it simple, stupid and synchoronous with your project. 嗯，别小看后半句噢，其实是一件非常难滴事情呢。因为锻炼你的写作技巧，尽量使得文档简洁又易懂，也许需要一些时间的锻炼，都能达到。但是synchoronous with your project需要的可是你长期的坚持啊。如果你的项目中某方面的改变牵扯到一些文档，会造成一些文档的过时，那么不要犹豫，立即更新它吧。真的不骗你，bad document的味道不比代码中bad smile造成的伤害小多少。</p>
<p>好吧，最后的结论就是，<strong>尽量写具备自描述能力的代码。如果某些时候，必须要写文档才能解决问题的时候，记得随时更新它。使它和你的项目保持同步。</strong></p>

]]></content:encoded>
			<wfw:commentRss>http://blog.ranxiang.com/2009/03/12/%e8%af%b4%e8%af%b4%e9%a1%b9%e7%9b%ae%e4%b8%ad%e6%96%87%e6%a1%a3%e7%9a%84%e9%82%a3%e7%82%b9%e4%ba%8b/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>A New Start, A Better Start!!~~~~~</title>
		<link>http://blog.ranxiang.com/2007/10/21/a-new-start-a-better-start/</link>
		<comments>http://blog.ranxiang.com/2007/10/21/a-new-start-a-better-start/#comments</comments>
		<pubDate>Mon, 22 Oct 2007 06:46:42 +0000</pubDate>
		<dc:creator>ranxiang</dc:creator>
				<category><![CDATA[未分类]]></category>
		<category><![CDATA[javascript]]></category>
		<category><![CDATA[job]]></category>
		<category><![CDATA[offer]]></category>
		<category><![CDATA[rails]]></category>
		<category><![CDATA[ruby]]></category>
		<category><![CDATA[work]]></category>

		<guid isPermaLink="false">http://blog.ranxiang.com/?p=17</guid>
		<description><![CDATA[&#160; &#160; 明天，我就要加入一家新的公司，新的团队老。在家憋了3个多月，终于放出来了。&#160;&#160;&#160; 从此以后，主要滴开发语言将由单纯滴Java，变成Rails和JavaScript。终于摆脱了繁琐滴JavaEE，即将面对滴是一个全新滴未知滴世界。我对此充满了好奇。&#160;&#160;&#160; Rails现在可以说走到现在，已经证实了自己，被越来越多的单位与企业用作商用。而JavaScript由于其本身的广泛性，以及AJAX的推动。已经被很多人看成了the next big thing。我对于解释性语言滴兴趣也越来越浓。相信这份工作能给我带来很多的乐趣，并使我成长。&#160;&#160;&#160; 今天去了趟家旁边的书店，本来打算买《Ruby Cookbook》，结果刘同学说公司已经有了，关于这方面的图书以后都可以请求公司提供。嗯！~~~~~~这个消息真滴是太好了，我一直很希望呆在这样的企业。因为能让自己感觉到开发人员受到了重视。在书店逛来逛去，想找《AJAX模式与最佳实践》，可惜没有。然后挑了两本别的《Beyond Java》和《Head First设计模式》。后者是什么珍藏版，其实就带了一副海报而已。海报里面画满了各式样的模式，以及超浓缩但确不太难懂的概括。&#160;&#160;&#160; 给PSP充满了电，COPY了一些电子书，音乐；给准备拿到公司放着的书写上了自己的名字，放到了包里。&#160;&#160;&#160; 嗯，好几个月没有去工作了，现在的心情仿佛跟以前放暑假盼着开学般。期待着新的同事，团队，以及要做的事情。&#160;&#160;&#160; 我相信对于我来说，这又将是一个新的开始，更好滴开始。我会认真滴工作，并为着自己的理想加倍努力着。 PS： 最后滴最后，我红着粉嘟嘟滴小脸，再次感谢刘同学滴推荐。8然，像我介种高中毕业证都米有滴小孩，怎么能找到自己满意滴工作咧。]]></description>
			<content:encoded><![CDATA[
<div class="topsy_widget_data topsy_theme_blue" style="float: right;margin-left: 0.75em; background: url(data:,%7B%20%22url%22%3A%20%22http%253A%252F%252Fblog.ranxiang.com%252F2007%252F10%252F21%252Fa-new-start-a-better-start%252F%22%2C%20%22style%22%3A%20%22big%22%2C%20%22title%22%3A%20%22A%20New%20Start%2C%20A%20Better%20Start%21%21%7E%7E%7E%7E%7E%20%23javascript%20%23job%20%23offer%20%23rails%20%23ruby%20%23work%22%20%7D);"></div>
<p>&nbsp; &nbsp; 明天，我就要加入一家新的公司，新的团队老。在家憋了3个多月，终于放出来了。<br />&nbsp;&nbsp;&nbsp; 从此以后，主要滴开发语言将由单纯滴Java，变成Rails和JavaScript。终于摆脱了繁琐滴JavaEE，即将面对滴是一个全新滴未知滴世界。我对此充满了好奇。<br />&nbsp;&nbsp;&nbsp; Rails现在可以说走到现在，已经证实了自己，被越来越多的单位与企业用作商用。而JavaScript由于其本身的广泛性，以及AJAX的推动。已经被很多人看成了the next big thing。我对于解释性语言滴兴趣也越来越浓。相信这份工作能给我带来很多的乐趣，并使我成长。<br />&nbsp;&nbsp;&nbsp; 今天去了趟家旁边的书店，本来打算买《Ruby Cookbook》，结果<a href="http://blog.donews.com/liusong1111">刘同学</a>说公司已经有了，关于这方面的图书以后都可以请求公司提供。嗯！~~~~~~这个消息真滴是太好了，我一直很希望呆在这样的企业。因为能让自己感觉到开发人员受到了重视。在书店逛来逛去，想找《AJAX模式与最佳实践》，可惜没有。然后挑了两本别的《Beyond Java》和《Head First设计模式》。后者是什么珍藏版，其实就带了一副海报而已。海报里面画满了各式样的模式，以及超浓缩但确不太难懂的概括。<br />&nbsp;&nbsp;&nbsp; 给PSP充满了电，COPY了一些电子书，音乐；给准备拿到公司放着的书写上了自己的名字，放到了包里。<br />&nbsp;&nbsp;&nbsp; 嗯，好几个月没有去工作了，现在的心情仿佛跟以前放暑假盼着开学般。期待着新的同事，团队，以及要做的事情。<br />&nbsp;&nbsp;&nbsp; 我相信对于我来说，这又将是一个新的开始，更好滴开始。我会认真滴工作，并为着自己的理想加倍努力着。</p>
<p>PS： 最后滴最后，我红着粉嘟嘟滴小脸，再次感谢<a href="http://blog.donews.com/liusong1111">刘同学</a>滴推荐。8然，像我介种高中毕业证都米有滴小孩，怎么能找到自己满意滴工作咧。</p>

]]></content:encoded>
			<wfw:commentRss>http://blog.ranxiang.com/2007/10/21/a-new-start-a-better-start/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
		<item>
		<title>A Beautiful Day</title>
		<link>http://blog.ranxiang.com/2007/10/18/a-beautiful-day/</link>
		<comments>http://blog.ranxiang.com/2007/10/18/a-beautiful-day/#comments</comments>
		<pubDate>Thu, 18 Oct 2007 14:55:39 +0000</pubDate>
		<dc:creator>ranxiang</dc:creator>
				<category><![CDATA[未分类]]></category>
		<category><![CDATA[ajax]]></category>
		<category><![CDATA[jquery]]></category>
		<category><![CDATA[rails]]></category>
		<category><![CDATA[work]]></category>

		<guid isPermaLink="false">http://blog.ranxiang.com/?p=15</guid>
		<description><![CDATA[&#160; &#160; 周一下午，接到刘同学公司的电话面试，简单聊了一些，感觉还不错。然后互相加了MSN，对方要求我做一个DEMO。当时充满乐观滴说了一天就OK，结果真正做的时候发现了很多困难。然后延期，直到刚刚，终于做出来了自己稍微满意的地步，提交了。嗯，长长了舒了口气，我要睡个安稳觉老。 &#160; &#160; 任务就是做一个页面，里面有一些AJAX方式的小逻辑。要求用ror和jquery，ror虽然没有实战经验，但也学习了一段时间了，下过一些功夫。可jquery，貌似在很久以前就看过一眼，基本上属于只听伊人声，从未见伊人面的境界啊。然后恶补，做技术探索。这个任务还要求有拖拽效果，于是想想基于jquery的js库什么能做到呢。前几天刚看了下新发布的jquery-ui就有这个效果，嗯，那就尝试用它吧。还好，不是太难，不过文档实在太少，最后在googlegroup里找到了答案。&#160; &#160; 任务上明确说了要做一个分页效果，一开始没当回事，后来才发现麻烦大了。哎哎，默认的paginate达不到我要的效果滴。结果就google啊，try啊。尝试will paginate插件，结果按照找到的文档做，发现依然有问题。最后实在崩溃，决定自己写算了。然后找了个示例代码，简单改吧改吧，结果就OK了。&#160; &#160; 最痛苦滴事情莫过于JS调试了。嗯，像俺这种做ServerSide好多年滴愚人，突然间做AJAX效果，还不是以前自学时玩的那种巨傻的演示，所以实在是糟糕透了。bug满天飞，气的我是满头大汗啊。还好，凭着我坚定滴信念。彪悍的人生全用alert给调完了一遍。最后测试一圈没问题之后，心跳终于恢复到了平均值。然后开始想念以前呆过的那些公司里做前台JS的同事，好想立刻飞到他们面前，深深鞠上一躬：同志们辛苦了。&#160;&#160;&#160; 自从把这个blog升级到了MT4之后就开始非常注重web standards，这次做这个任务一开始，也就早早的把table换成了div和span。可是，换标签易，写CSS难啊。像我这种巨没审美滴人最后凭借Dreamweaver还是战胜了重回table的诱惑，至少给页面添加了个大概模样。然后突然间感慨，1个月前装上windows是正确滴选择，不然哪有dreamweaver相助咧。嗯，看来过几天等Ubuntu 7.10发布后，我也不能把windows卸载了。关键时刻，上面那些linux没有的软件还是非常重要滴。&#160;&#160;&#160;&#160; 嗯，码了这么多字，发现窗户口的小鸟都开始JJYY了，听的我神清气爽。今天应该是个好天吧。希望白天阳光晒的足足滴，好让我美美滴睡上一觉。&#160;&#160;&#160;&#160; 虽然这会感觉有点累了，但是心里确其爽无比。因为在短时间内学习了新的技术，还做出来了小东西实在够开心的。所以说，人，还是有压力才有动力啊。这两天学的东西，就比自己学一个礼拜的进步要大。嗯~~~~~还是快点上班吧！~！~！~~~~~~~，不然脑子都生锈了。阿门，如来，耶稣，观世音，真主啊，快点赐我一份好工作哈。]]></description>
			<content:encoded><![CDATA[
<div class="topsy_widget_data topsy_theme_blue" style="float: right;margin-left: 0.75em; background: url(data:,%7B%20%22url%22%3A%20%22http%253A%252F%252Fblog.ranxiang.com%252F2007%252F10%252F18%252Fa-beautiful-day%252F%22%2C%20%22style%22%3A%20%22big%22%2C%20%22title%22%3A%20%22A%20Beautiful%20Day%20%23ajax%20%23jquery%20%23rails%20%23work%22%20%7D);"></div>
<p>&nbsp; &nbsp; 周一下午，接到刘同学公司的电话面试，简单聊了一些，感觉还不错。然后互相加了MSN，对方要求我做一个DEMO。当时充满乐观滴说了一天就OK，结果真正做的时候发现了很多困难。然后延期，直到刚刚，终于做出来了自己稍微满意的地步，提交了。嗯，长长了舒了口气，我要睡个安稳觉老。</p>
<p>&nbsp; &nbsp; 任务就是做一个页面，里面有一些AJAX方式的小逻辑。要求用ror和jquery，ror虽然没有实战经验，但也学习了一段时间了，下过一些功夫。可jquery，貌似在很久以前就看过一眼，基本上属于只听伊人声，从未见伊人面的境界啊。然后恶补，做技术探索。这个任务还要求有拖拽效果，于是想想基于jquery的js库什么能做到呢。前几天刚看了下新发布的jquery-ui就有这个效果，嗯，那就尝试用它吧。还好，不是太难，不过文档实在太少，最后在googlegroup里找到了答案。<br />&nbsp; &nbsp; 任务上明确说了要做一个分页效果，一开始没当回事，后来才发现麻烦大了。哎哎，默认的paginate达不到我要的效果滴。结果就google啊，try啊。尝试will paginate插件，结果按照找到的文档做，发现依然有问题。最后实在崩溃，决定自己写算了。然后找了个示例代码，简单改吧改吧，结果就OK了。<br />&nbsp; &nbsp; 最痛苦滴事情莫过于JS调试了。嗯，像俺这种做ServerSide好多年滴愚人，突然间做AJAX效果，还不是以前自学时玩的那种巨傻的演示，所以实在是糟糕透了。bug满天飞，气的我是满头大汗啊。还好，凭着我坚定滴信念。彪悍的人生全用alert给调完了一遍。最后测试一圈没问题之后，心跳终于恢复到了平均值。然后开始想念以前呆过的那些公司里做前台JS的同事，好想立刻飞到他们面前，深深鞠上一躬：同志们辛苦了。<br />&nbsp;&nbsp;&nbsp; 自从把这个blog升级到了MT4之后就开始非常注重web standards，这次做这个任务一开始，也就早早的把table换成了div和span。可是，换标签易，写CSS难啊。像我这种巨没审美滴人最后凭借Dreamweaver还是战胜了重回table的诱惑，至少给页面添加了个大概模样。然后突然间感慨，1个月前装上windows是正确滴选择，不然哪有dreamweaver相助咧。嗯，看来过几天等Ubuntu 7.10发布后，我也不能把windows卸载了。关键时刻，上面那些linux没有的软件还是非常重要滴。<br />&nbsp;&nbsp;&nbsp;&nbsp; 嗯，码了这么多字，发现窗户口的小鸟都开始JJYY了，听的我神清气爽。今天应该是个好天吧。希望白天阳光晒的足足滴，好让我美美滴睡上一觉。<br />&nbsp;&nbsp;&nbsp;&nbsp; 虽然这会感觉有点累了，但是心里确其爽无比。因为在短时间内学习了新的技术，还做出来了小东西实在够开心的。所以说，人，还是有压力才有动力啊。这两天学的东西，就比自己学一个礼拜的进步要大。嗯~~~~~还是快点上班吧！~！~！~~~~~~~，不然脑子都生锈了。阿门，如来，耶稣，观世音，真主啊，快点赐我一份好工作哈。</p>

]]></content:encoded>
			<wfw:commentRss>http://blog.ranxiang.com/2007/10/18/a-beautiful-day/feed/</wfw:commentRss>
		<slash:comments>0</slash:comments>
		</item>
	</channel>
</rss>
