Blogs

前言

项目中文档管理是一个比较麻烦的事情，一般的做法都是写word文档，或者pdf；针对代码或者接口文档高级一点的可以使用Doxygen或者swagger这样的工具自动生成更新文档。但是项目中还有很多文档有是图文混合的。那这样的文档怎么有效管理呢？

在找了几个工具之后，发现了一个比较合适的工具gitbook。这个工具之前也接触过，主要是用来书籍编写管理，这方面确实做的非常专业。但是我发现用来做文档管理也是非常好用的，所以拿来测试了一下，效果还是不错的。看看这个效果，也是左右分栏，左边是目录分类列表，右边是内容。还可以直接进行搜索。

本文是在今年梳理的关于FaaS的一个文档，主要目标是梳理FaaS的基本概念，发展势头，应用场景和一些基本的架构设计。

gopher-lua这个组件，这个是使用golang重写的支持Lua5.1的虚拟机，在执行上可以直接golang无缝结合，有非常好的go的api接口，在使用上也流畅很多，在实现思路上也采用golang的一些思路，和golang结合更好。

gitbook其实是一个nodejs的一个工具软件，是基于nodejs的。gitbook.com就是基于这个工具开发的系统，他是一个提供了在线文档书籍开发管理的系统，它同时打通了github。

golang在1.8以后的tool工具中默认移除了yacc工具，如果要使用只能自己安装。

今天在测试代码中要用一下这个工具，突然发现没有，需要自己安装首先这里下载代码： http://github.com/golang/tools/cmd/goyacc/

其实操作系统没有关系，主要还是Dockerfile的编写和执行，过程来说比较简单。

我的dockerfile如下，主要是用于golang和c++的开发，所以相关软件安装都是和这方面有关的。本来打算使用163的源的，后来看了一下官方源速度也还不错，就直接用官方的源了。

之前一直使用window安装虚拟机的方式来做linux应用，这次想使用docker来试试，这里顺便记录一下，部分资料来自网上。

打开控制面板 - 程序和功能 - 启用或关闭Windows功能，勾选Hyper-V，然后点击确定即可，如图：

这边文档简要的描述了Flink怎么样调度作业和Flink在JobManager中如何表述和跟踪作业。

Component Stackhttps://ci.apache.org/projects/flink/flink-docs-release-1.6/internals/components.html#component-stack组件栈作为一个软件栈，Flink是一个分层设计的系统。不同的层基于底层创建，不断提升程序表现的抽象。