最近要整合团队的文档，然后输出到其他团队。然后很多接口并不是由我提供的，我也只能参照大家在 gitlab 上写的 wiki 来整理起来，有些文档变动我可能也不能及时收集，所以想找这样的工具，大家都能方便地编辑文档，而且最后整合的文档能比较齐全，样式也好看点。gitlab 提供的 wiki 功能其实也是挺好用的，但是大多没有整理好，一个仓库一个对应的文档，而且翻页查找什么的也不是特别方便。最后找了好多文档框架，比较好用的几个多是专门用来提供 api 文档的，组里的文档多是 markdown 格式的，不想进行大改。最后选定了 gitbook 来做这样一个整合。

为了更细致地了解 package.json 中每个字段，特意将官方文档翻译了一下，加入了一点点自己经验和理解。
文档地址：npm-package.json

说明

本文档是你所需要了解的关于你的 paclage.json 文件中你需要什么的全部信息。package.json 必须是真正的 JSON，而不仅仅是 JavaScript 对象字面量。
本文中描述的许多行为都受 npm-config 中描述的配置设置的影响。

原文：understanding-asynchronous-javascript-the-event-loop

JavaScript 是一种单线程语言，这意味着一次只能发生一件事情。也就是说，JavaScript 引擎只能在单个线程中一次处理一个语句。

虽然单线程语言简化了代码编写，因为你无需担心并发问题，但是这也意味着您无法在不阻塞主线程的情况下执行网络访问等长时间操作。

常常“买书如山倒，读书如抽丝”，去年一年就买了不下三十本，但是读完的确了了无几。今年呢，打算少买一点了，先把去年买的看完先。
开年第一本读完的就是这本《算法小时代：从数学到生活的历变》。

最近入门 Python，然后看到一篇英文资料在 learnxinyminutes 上，对内容进行了翻译并稍加修改，加入了自己的理解和补充，可能翻得不好，待日后我对 Python 有更深入理解了再进行修改和补充。

有不妥的地方也欢迎提出修改意见，项目地址

最近重温了一遍《你不知道的 JS》，跟看第一遍的感受完全不一样，感觉先前漏了好多细节，结合日常开发工作，更多了一些实践感触。有些时候我知道怎么完成一个需求，但是往往为了完成而完成，没有进一步去想里面的细节和原理。看完书之后就会带着问题去思考日常业务代码里有没有更好的优化方式。

Babel 是什么？

Babel 是一个 JavaScript 编译器。

这是 Babel 官网(中文)上的一句介绍。实际上，Babel 可以将 ES6 代码转为 ES5 代码，让你不用去考虑环境是否支持，而直接使用 ES6 来编写代码。

文章目的

收集日常工作及学习过程中，项目报错的内容及解决办法。

先从一个需求说起

这次的需求是这样的：有一个展示页面，需要加载一些网络图片，而且是要让图片按原来的图片大小等比例展示的，但是这些网络图片是不预先知道其长宽的。

先从一个需求说起

需求是这样的：为满足线上版本紧急更新重要内容（包括 JS/HTML/CSS/IMAGE 等），使用 CodePush 进行热更新， 当有新的更新内容需要更新时，客户端弹出自定义的更新提示弹窗，用户可以选择点击立即更新进行更新，或者点击关闭按钮忽略这次更新。