Google 的工程师 Ben Lisbakken 利用他的 20% 时间捣鼓出一个展示 Google 所提供的各种 JavaScript API 功能的界面。开发人员通过这个界面可以迅速检索这些 API 的常用功能，然后对这些示例代码进行在线修改即时查看执行结果。
这个东西比直接去阅读那些枯燥的 API 文档然后在本地自己写测试代码要好用多了，强烈推荐。目前里面包含的API有：
其 中 Libraries API 就是常用 JavaScript 库的 CDN 。对于安全性没有特别要求的中小型网站来说，使用 Google 集中提供的js库（比如jquery）可以减少一次自己服务器的http连接，同时使用 Google CDN 的人越多，这些库文件在浏览器缓存里面存在的可能性就越大，访问速度也就越快。如果 Google 能够永远“不作恶”，永远不倒闭，那么使用他的 Libraries API 绝对比在自己的服务器上放一份拷贝要好。
有趣的是虽然 Google 官方建议通过引用 <script src=”http://www.google.com/jsapi”></script> 之后调用 google.load(“jquery”, “1″); 的方法来最高效的使用这些 Libraries API ，但就连这个 Googles AJAX APIs Playground 也是直接用 <script src=”http://ajax.googleapis.com/ajax/libs/jquery/1.2.6/jquery.min.js” type=”text/javascript” charset=”utf-8″></script> 这样的方式来调用 CDN 中的 js 代码库的。
两种方法要我选肯定也是选直接引用的，反正官方文档里面明确说明两种方法都可以，并且有给出每个库对应的引用URL，没必要多那么一举嘛。
YUI Team实践出了一个高效易协作的前端代码开发流程：代码首先由Ant来组织管理和版本化、接着由JsLint来验证，然后由YUI Doc文档化、最后由YUI Compressor进行压缩发布。上个月初，YUI Team公布了这个新的JavaScript API文档生成工具YUI Doc，它本来专门为YUI提供API级别的文档的，现在它开源为人民服务了。
YUI Doc和JavaDoc、JSDoc和JsDoc Toolkit相似。YUI Doc是由注解驱动（comment-driven ）的系统，它通过解析代码中描述结构的注解来生成文档。由于它纯粹的依赖于注解，所以并不像一些模拟系统一样需要有惯用语和代码模式。更详细的介绍可以看YUI Doc的官方文档和YUI blog上的《YUI Doc: A New Tool for Generating JavaScript API Documentation》（由于YUI blog咱们无法访问，比较好的解决方案就是在Google Reader中订阅它的Feed，直接输入 http://yuiblog.com即可。）
YUI Doc是基于Python开发，且依赖几个扩展库，加之其Getting Started写的也比较含糊，所以如何使用这个工具反而成为第一道门槛，尤其对于那些对Python不熟悉的同学来说。所以，下面的重点是介绍如何在Windows上使用YUI Doc：
- 下载Python2.5.2安装之。
虽然Python3.0和Python2.6都已经出来很久了，但之所以依旧选择Python2.5.2，是因为后面要用到的安装Python扩展库的工具setuptools在Windows下的最新版本对应的是Python2.5。我不知道它是否支持2.5以上，有兴趣的可以试试。
- 下载setuptools-0.6c9.win32-py2.5.exe并安装之，setuptools会自动安装到Python所在安装目录的Scripts目录下。
setuptools为Python提供了简单的包管理和发行功能。后面的扩展库的安装就是利用它的easy_install，非常方便。有兴趣的可以看看《可爱的 Python: 使用 setuptools 孵化 Python egg》。
- 为了使用方便需要配置一下“环境变量”，即在“我的电脑 》右键 》属性 》高级 》环境变量 》系统变量 》 选中Path 》 编辑”，在弹出框中加入：
;D:\Program Files\python;D:\Program Files\python\Scripts
然后应用即可。前面的两个路径分别是我的Python和setuptools的安装路径，你需要修改成你自己的。
- 开始 》运行 》(Win + R)输入“cmd”，输入：
python -c "import pkg_resources"
没有任何输出，即表示setuptools安装成功。接着依次输入运行：
easy_install Pygments
easy_install simplejson
easy_install Cheetah
setuptools会自动寻找并下载Pygments、SimpleJSON和Cheetah这三个扩展库，并安装它。
- 下载YUI Doc，并解压在某个目录下。复制其bin目录下的example.bat文件，重命名为test.bat，然后用记事本或其他编辑器打开并配置它:
SET yuidoc_home="D:\yui\yuidoc"
REM YUI Doc的路径
parser_in="D:\yui\src"
REM 要生成文档的JS文件路径，比如为了测试就我临时建一个，里面就放着YUI 的 dom.js
parser_out="D:\yui\src\parser"
REM YUI Doc会把解析的JS文件提取出来所要存放的位置
generator_out="D:\yui\src\generator"
REM 生成文档存放的位置
保存并运行test.bat后，就会发现D:\yui\src中多了parser和generator两个目录，而generator中正是你要的文档。
学会使用工具仅仅是开始了一小步，仔细看看YUI Doc的官方文档吧，利用其来促使我们写出更高效优雅的前端代码并惠及更多的人才是一大步。
转载：http://dancewithnet.com/2008/12/30/why-start-yui-doc/