02.proof-of-work.ipynb

{
 "cells": [
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "# 如何证明你真的读过这本书？"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 積ん読"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "日语里有个很好玩的词，“**積ん読**”（[tsundoku](https://en.wikipedia.org/wiki/Tsundoku)）：\n",
    "\n",
    "> 指那些买回来堆在那里还没读过的（甚至后来干脆不看了的）书……\n",
    "\n",
    "细想想，每个人都有很多很多“積ん読”。小时候我们拿回家的教科书中就有相当一部分，其实就是“積ん読”，虽然那时候掏钱买书的是父母，不仔细看、或者干脆不看的时候，也知道自己在偷懒…… 再后来就是“主动犯罪”了 —— 比如，很多人买到手里的英语词汇书是根本就没有翻到过第二个列表的，乃至于过去我常常开玩笑说，中国学生都认识一个单词，*abandon*，不是吗？这个单词是很多很多人“决心重新做人”而后“就这样罢”的铁板钉钉的见证者。\n",
    "\n",
    "在没有电子书的时代，印刷版书籍多少还有一点“装饰品”功用，可是到了电子书时代，谁知道你的设备里有多少付费书籍呢？攒下那么多，其实并没有炫耀的地方，给谁看呢？据说，Kindle 的后台数据里可以看到清楚的“打开率”，大抵上也是在 $^1/_4$ ~ $^1/_3$ 之间，也就是说，差不多有 $^2/_3$ ~ $^3/_4$ 的电子书籍被购买下载之后，从来就没有被打开过。\n",
    "\n",
    "如此看来，付费之后并不阅读，只能欺骗一个对象了：自己。跟心理学家们之前想象的不同，我认为人们通常是不会欺骗自己的，至少很难“故意欺骗自己”。所以，对于“买了之后坚决不读”这个现象，我不认为“给自己虚妄的满足感”是最好的解释。\n",
    "\n",
    "更朴素一点，更接近真相的解释是：\n",
    "\n",
    "> 那百分之七八十的人，其实是想着给自己一个希望……\n",
    "\n",
    "—— 等我有空了一定看。嗯。\n",
    "\n",
    "说来好笑，其实每个人共同拥有的目标之一是这样的：\n",
    "\n",
    "> 成为前百分之二十的少数人……\n",
    "\n",
    "然而，PK 掉百分之七八十的人的方法真的很简单很简单啊：\n",
    "\n",
    "> 把买来的书都真真切切地认真读过就可以了。\n",
    "\n",
    "这实在是太简单了罢？！可是…… 我知道你刚刚那个没出息的闪念：\n",
    "\n",
    "> 那我少买书甚至不买书不就可以了吗？\n",
    "\n",
    "你自己都知道这是荒谬的，却忍不住为你的小聪明得意 —— 其实吧，幸亏有你们在，否则我们怎么混进前百分之二十呢？"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## PoW"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "比特币这个地球上第一个真正被证明为可行的区块链应用中有一个特别重要的概念，叫做“**工作证明**”（Proof of Work）—— 你干活了就是干活了，你没干活就是没干活，你的工作是可被证明的……\n",
    "\n",
    "借用这个思路，我设计了个方法，让你有办法证明自己就是看过这本书，就是读完了这本书 —— 你能向自己也向别人证明自己曾经的工作…… 是不是挺好？\n",
    "\n",
    "证明的方法是使用 [github.com](https://github.com) 这个网站以及它所提供的工具 **git**。"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 具体步骤"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "请按照以下步骤操作：\n",
    "\n",
    "> 1. 注册 [github.com](https://github.com) 帐号 —— 无论如何你都必须有 github 账户；\n",
    "> 2. 使用浏览器访问 [https://github.com/selfteaching/the-craft-of-selfteaching](https://github.com/selfteaching/the-craft-of-selfteaching)；\n",
    "> 3. 在页面右上部找到“Fork”按钮，将该仓库 Fork 到你自己的账户中；\n",
    "> 4. 使用 `git clone` 命令或者使用 [Desktop for Github](https://desktop.github.com/) 将 [the craft of selfteaching](https://github.com/xiaolai/the-craft-of-selfteaching) 这个你 Fork 过来的仓库克隆到本地；\n",
    "> 5. 按照 [Jupyterlab 的安装与配置](T-appendix.jupyter-installation-and-setup.ipynb) 的说明在本地搭建好 Jupyterlab —— 如果在 Jupyterlab 中浏览本书的话，其中的所有代码都是可以“当场执行”的，并且，你还可以直接改着玩……\n",
    "> 6. 在阅读过程中，可以不断通过修改文章中的代码作为练习 —— 这样做的结果就是已阅读过的文件会发生变化…… 每读完一章，甚至时时刻刻，你都可以通过 `git commit` 命令向你自己 Fork 过来的仓库提交变化 —— 这就是你的阅读工作证明；\n",
    "> 7. 仓库里有一个目录，`my-notes`，你可以把你在学习过程中写的笔记放在那里；\n",
    "> 8. 仓库里还有另外一个目录，`from-readers`；那是用来收集读者反馈的 —— 将来你可以写一篇《我的自学之路》，放在这个目录里，单独创建一个分支，而后提交 `pull request`，接受其他读者投票，若是达到一定的赞同率，那么你的文章就会被收录到主仓库中被更多人看到，激励更多的人像你一样走上自学之路……\n",
    "\n",
    "当然，为了这么做，你还要多学一样反正你早晚都必须学会的东西，Git —— 请参阅附录 《[Git 入门](T-appendix.git-introduction.ipynb)》。\n",
    "\n",
    "时间就是这样，我们没办法糊弄它。而有了 git 这样的工具之后，我们在什么时候做了什么样的工作，是很容易证明的 —— 这对我们来说真是天大的好事。"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## 如何使用 Pull Request 为这本书校对"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "另外，在你阅读的过程中，发现有错别字啊、代码错误啊，甚至有“更好的表述”等等，都可以通过 `pull request` 来帮我改进 —— 这也是一种“工作证明”。"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "(1) 使用浏览器访问 https://github.com/selfteaching/the-craft-of-selfteaching\n",
    "\n",
    "(2) 点击右上角的“Fork 按钮”，将该仓库 Fork 到你的 Github 账户中\n",
    "\n",
    "![](images/github-fork.png)\n",
    "\n",
    "(3) 创建一个新分支，可以取名为 `from-<your_username>`，比如，`by git.basic.tutorial`；\n",
    "\n",
    "![](images/github-new-branch.png)\n",
    "\n",
    "(4) 在新分支下进行修改某个文件（示例图片中是修改了 README.md 文件），而后提交 —— 提交前不要嫌麻烦，一定要在 Comment 中写清楚修改说明：\n",
    "\n",
    "![](images/github-commit.png)\n",
    "\n",
    "(5) 在页面顶部选择 Pull request 标签：\n",
    "\n",
    "![](images/github-pull-request.png)\n",
    "\n",
    "而后点击 `Compare & pull request` 按钮 —— 如果看不到这个按钮，那就点击下面刚刚修改文件的链接，如上图中的“Update README.md”（这是你刚刚提交修改时所填写的标题）。\n",
    "\n",
    "![](images/github-open-pull-request.png)\n",
    "\n",
    "确认无误之后，点击 `Create pull request` 按钮。\n",
    "\n",
    "![](images/github-create-pull-request.png)\n",
    "\n",
    "(6) 随后，Github 用户 [@xiaolai](https://github.com/xiaolai) —— 就是我，即，the-craft-of-selfteaching 这个仓库的所有者，会被通知有人提交了 Pull request，我会看到：\n",
    "\n",
    "![](images/github-confirm-merge.png)\n",
    "\n",
    "在我确认这个 Pull request 修改是正确的、可接受的之后，我就会按 `Merge pull request` 按钮 —— 如此这般，一个修正就由你我共同完成了。\n",
    "\n",
    "![](images/github-merged-pull-request.png)\n",
    "\n",
    "\n",
    "**注意**\n",
    "\n",
    "提交 Pull request 的时候，最佳策略如下：\n",
    "\n",
    "> * 尽量每次只提交一个小修改；\n",
    "> * 提交时尽量简短且清楚地说明修改原因；\n",
    "> * 耐心等待回复。\n",
    "\n",
    "当自己的 Fork 过来的仓库已经被你在本地“玩残”了的时候，它千万不能当作用来提交 Pull request 的版本。自己本地怎么玩都无所谓，但，需要向别人提交 Pull request 的时候，必须重新弄一个当前最新版本到本地，而后再在其基础上修改。"
   ]
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.7.1"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 2
}