在服务端开发过程中，我们需要提供一份 API 接口文档给 Web 端和移动端使用。实现 API 接口文档编写工作，有很多种方式，例如通过 Word 文档编写，或者通过 MediaWiki 进行维护。此外，还有比较流行的方式是利用 Swagger 自动化生成文档。这里，笔者想分享另一个 Web API 文档生成工具 apidoc。

本文整理于《重构改善既有代码的设计》，这本书是用java写的，整理的目的是为了自己能写出更健壮、更具扩展性的代码，为以后的编码做参考。

在本教程中我们将写一个小的GraphQL server 来响应Todo List app的请求。你也可以 在众多app中来挑选，但是这些日子我开始使用React做项目，所以我将会选择React来做前端框架。不过，你也可以挑选你用得习惯的任何js框架。

我想找出所有的 *.doc 文件并将它们创建成一个 tar 包，然后存储在 /nfs/backups/docs/file.tar中。是否可以在 Linux 或者类 Unix 系统上查找并 tar 打包文件？find 命令用于按照给定条件在目录层次结构中搜索文件。tar 命令是用于 Linux 和类 Unix 系统创建 tar 包的归档工具。让我们看看如何将 tar 命令与 find 命令结合在一个命令行中创建一个 tar 包。

今天 PyTorch 刚好一周年。自发布以来，由于调试、编译等多方面的优势，它成为 2017 年热度极高的框架之一。本文内容介绍了开源一周年以来，PyTorch 取得的成绩。在一些指标上，PyTorch 也与 TensorFlow 做了同期对比。PyTorch 是不是 2017 年的明星框架？

Mysql 的索引是我们常用的，但实际了解多少呢？下面通过几个案例小问题来测验下，后面会有答案及相关解释

Mark Hinkle，Node基金会执行总监，曾说道：‘对于Node.js，2017年是杰出的一年’。这点我们完全同意。 Node.js在技术领域有着令人羡慕的地位，每天线上运行的Node实例超过8.8百万个，并且这个数字在过去一年里飞涨。同时在一年时间内，Node.js的贡献者已经从1,100人发展到1,500人，每周下载的npm包超过30亿个。

在过去的 2017 年中，Java 世界中发生了许多前所未有的变化，其部分原因在于 Java 9 的推出，尽管它推后了近一年的时间。然而，随着时间的推移人们可能会发现，推出 Java 9 版本的意义，远没有随该新版本一并推出的 Java 版本发布周期变更为每六个月一次的意义更为重大。Java 版本发布周期的变更，意味着在 2018 年将会推出两个 Java 新版本，而非一个。