Google 技术写作课程搬运，原文地址：https://developers.google.com/tech-writing/overview?hl=zh-cn Technical Writing Courses Every engineer is also a writer. This collection of courses and learning resources aims to improve your technical documentation. Learn how to plan and author technical documents. You can also learn about the role of technical writers at Google. Overview of technical writing courses The following table summarizes the technical writing courses: Take this course… Title Focus Pre-Class In-Class first Technical Writing One the critical basics of technical writing 2 hours 2 to 2.5 hours second Technical Writing Two intermediate topics in technical writing 1 hour 2 to 2.5 hours The pre-class components introduce topics; the in-class components help students integrate those topics. That said, the pre-class lessons on their own still provide a valuable educational experience. ...

[TOC] 祈祷式编程 祈祷式编程 如果代码中包含以下代码 或者上线后进行这种活动 那么这种编程方式就是祈祷式编程。 用流程图表示基本就是这个样子。 祈祷式编程有什么危害呢？ 累，每次写完代码还需要再祈祷 不受控，代码运行结果主要看运气，大仙忙的时候可能保佑不了 解决这个问题有好多种方法，单元测试是其中之一。 单元测试 什么是单元测试 单元测试是由开发人员编写的，用于对软件基本单元进行测试的可执行的程序。 单元（unit）是一个应用程序中最小的课测试部分。（比如一个函数，一个类 google 把测试分成小型测试、中型测试和大型测试。单元测试基本和小型测试的作用类似，但是通常也会使用mock或者stub 的方式模拟外部服务。 理想情况下，单元测试应该是相互独立、可自动化运行的。 目的： 通常用单元测试来验证代码逻辑是否符合预期。完整可靠的单元测试是代码的安全网，可以在代码修改或重构时验证业务逻辑是否正确，提前发现代码错误，减少调试时间。设计良好的单元测试某些情况下可以比文档更能反应出代码的功能和作用。 单元测试这么多优点为什么有人不喜欢写单元测试呢？ 单元测试太费时间了，对于编写单元测试不熟练的新手来说，编写单元测试可能比写代码的还费时间 单元测试运行时间太长（这通常是单元测试设计不合理或者代码可测试性较差造成的 祖传代码，看都看不懂怎么写单元测试（这个确实优点棘手。。可以考虑先给新代码加单元测试 不会写单元测试 这篇文章主要关注第四个问题，如何写单元测试。 单元测试的结构 首先看一下单元测试的结构，一个完整的单元测试主要包括Arrange-Act-Assert（3A） 三部分。 Arrange–准备数据 Act–运行代码 Assert–判断结果是否符合预期 比如我们要给下面这段代码（golang）加单元测试： func Add(x, y int) int { return x + y } 单元测试代码如下： import "testing" func TestAdd(t *testing.T) { // arrange 准备数据 x, y := 1, 2 // act 运行 got := Add(x, y) //assert 断言 if got != 3 { t.Errorf("Add() = %v, want %v", got, 3) } } 如何编写好的单元测试 什么样的单元测试才是好的单元测试呢？ ...

题目：设计一个身份证查询系统，将身份证号md5 之后存储，输入md5值查询对应的身份证号。 要求：成本低，查询速度快 设计思路： 将所有可能的身份证号做一个简单的统计计算数据量 根据数据量选择存储方式 查询 身份证生成规则： 身份号码是特征组合码，由前十七位数字本体码和最后一位数字校验码组成。排列顺序从左至右依次为六位数字地址码，八位数字出生日期码，三位数字顺序码和一位数字校验码。 地址码： 表示编码对象常住户口所在县(市、旗、区)的行政区划代码。对于新生儿，该地址码为户口登记地行政区划代码。需要没说明的是，随着行政区划的调整，同一个地方进行户口登记的可能存在地址码不一致的情况。行政区划代码按GB/T2260的规定执行。 出生日期码：表示编码对象出生的年、月、日，年、月、日代码之间不用分隔符，格式为YYYYMMDD，如19880328。按GB/T 7408的规定执行。原15位身份证号码中出生日期码还有对百岁老人特定的标识，其中999、998、997、996分配给百岁老人。 顺序码： 表示在同一地址码所标识的区域范围内，对同年、同月、同日出生的人编定的顺序号，顺序码的奇数分配给男性，偶数分配给女性。 校验码： 根据本体码，通过采用ISO 7064:1983,MOD 11-2校验码系统计算出校验码。算法可参考下文。前面有提到数字校验码，我们知道校验码也有X的，实质上为罗马字符X，相当于10. 校验码算法 将本体码各位数字乘以对应加权因子并求和，除以11得到余数，根据余数通过校验码对照表查得校验码。 加权因子表： +-----------------------------------------------------------+ |位置序号|1 |2 |3 |4 |5 |6 |7 |8 |9 |10|11|12|13|14|15|16|17| +-----------------------------------------------------------+ |加权因子|7 |9 |10|5 |8 |4 |2 |1 |6 |3 |7 |9 |10|5 |8 |4 |2 | +-----------------------------------------------------------+ 校验码表: +----------------------------------------------------+ | 余数 | 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | +----------------------------------------------------+ | 校验码| 1 | 0 | X | 9 | 8 | 7 | 6 | 5 | 4 | 3 | 2 | +----------------------------------------------------+ 算法举例： 本体码为11010519491231002 ...

Docker 终端UI： https://github.com/jesseduffield/lazydocker 宝数据库内核月报：http://mysql.taobao.org/monthly/ 比较深入的数据库源码分析 手机号码归属地查询：https://apis-mp.gusibi.mobi/mobile/location?mobile=18512345678 使用serverless部署，无需服务器。源码地址：https://github.com/gusibi/oneplus/tree/master/mobile-attribution 手绘风格CSS：https://www.getpapercss.com/ Image-to-Image Demo： https://affinelayer.com/pixsrv/ 学霸用左边，学渣用右边：https://www.plainlanguage.gov/guidelines/words/use-simple-words-phrases/ 美国政府的一个网页，有几百条单词建议，指导你怎么写出简单的文章，不要用复杂的单词。 比如说，“a和b可以同时使用，也可以单独使用”，不要用 a and/or b，而要用 a or b or both。 微软上线了一套 Python 教程《Develop with Python on Windows》 微软上线了一套 Python 教程《Develop with Python on Windows》。 百度网盘下载器：https://github.com/b3log/baidu-netdisk-downloaderx 一款图形界面的百度网盘不限速下载器，支持 Windows、Linux 和 Mac。 参考链接 [1] 《Develop with Python on Windows》: https://docs.microsoft.com/zh-cn/windows/python/ 最后，感谢女朋友支持和包容，比❤️ 也可以在公号输入以下关键字获取历史文章：公号&小程序 | 设计模式 | 并发&协程 内推时间

【资料】史上最全的编程学习资料合集（持续更新） 【资料】一周 GitHub 开源项目推荐：阿里、腾讯、陌陌、bilibili…… 【资料】常用的 Go 框架、库和软件中文收录大全 【教程】高性能 Go 代码工坊（英文） 【文章】我用了10年 从深圳流水线厂妹做到纽约高薪程序员 【文章】2009年最热门的 iPhone 应用程序（英文） 苹果公司的应用商店即将满十周年，本文回顾了2009年最热门的付费应用和免费应用 【语言】v语言-语法综合了python和go 【工具】weixin python sdk 支持小程序云开发 【工具】网站收录了估值达到 10 亿美元的创业公司，实时更新 【工具】简洁的 Mac 图床客户端 uPic References [1] 【资料】史上最全的编程学习资料合集（持续更新）: https://github.com/toutiaoio/weekly.manong.io [2] 【资料】常用的 Go 框架、库和软件中文收录大全: https://juejin.im/post/5d14a319e51d4577407b1d77 [3] 【教程】高性能 Go 代码工坊: https://dave.cheney.net/high-performance-go-workshop/gopherchina-2019.html [4] 【文章】2009年最热门的 iPhone 应用程序: https://www.fastcompany.com/90356079/whatever-happened-to-the-hottest-iphone-apps-of-2009 [5] 【语言】v语言-语法综合了python和go: https://github.com/vlang/v [6] 【工具】weixin python sdk 支持小程序云开发: https://github.com/gusibi/python-weixin [7] 【工具】网站收录了估值达到 10 亿美元的创业公司，实时更新: https://dujiaoshou.io/ [8] 【工具】简洁的 Mac 图床客户端 uPic: https://github.com/gee1k/uPic 最后，感谢女朋友支持和包容，比❤️ 也可以在公号输入以下关键字获取历史文章：公号&小程序 | 设计模式 | 并发&协程 内推时间

1 宇宙模拟器 ：http://spaceengine.org 2 APIJSON：https://github.com/APIJSON/APIJSON APIJSON是一种为API而生的 JSON网络传输协议 以及 基于这套协议实现的ORM库。 后端接口和文档自动化，前端(客户端) 定制返回JSON的数据和结构 3 【文章】小火箭对SpaceX星链计划低轨巨型星座的分析：https://mp.weixin.qq.com/s/NNmI_cqwo4ba0ViJ9O7f3Q 这篇对SpaceX 星链计划 可行性进行了详细的分析，共11575字，101图。预计阅读时间：1小时15分钟 4 微软与 Google 共同开设的量子算法课程：https://brilliant.org/courses/quantum-computing/ 通过浏览器模拟的量子计算环境，学习量子算法 5 一个VPS搜索工具: https://anothervps.com/vps/ 可怜我linode 都用不了了 6 一些有趣的网站： https://www.ctolib.com Github开源项目收集网站 http://www.nicetool.net 实用工具比较多 http://www.mvyxws.com/ 以视频方式分享医学知识的网站 https://www.tikitiki.cn 自由的音乐，能够试听并下载全网音乐 https://showmore.com/zh/ 在线录制屏幕的工具 https://weibomiaopai.com 视频下载 7 PySnooper：https://github.com/cool-RR/PySnooper python DeBug工具 8 pyecharts：https://github.com/pyecharts/pyecharts Echarts 是一个由百度开源的数据可视化，pycharts 是Echarts 的python版。 9 LeetCodeAnimation：https://github.com/MisterBooo/LeetCodeAnimation 用动画的形式呈现解LeetCode题目的思路 10 ColorUI：https://www.color-ui.com/ 鲜亮的高饱和色彩，专注视觉的小程序组件库 iPhone X怎么强制关机？ iPhone X强制关机有三步： 按下音量+键然后松开； 按下音量-键然后松开； 之后按住侧边按钮（即电源键）直到iPhone X黑屏。 升级了iOS13，打电话的时候就停留在了通话界面，再也退不出去了。。只能用强制关机的方式。 才知道是这么个方式 最后，感谢女朋友支持和包容，比❤️ 也可以在公号输入以下关键字获取历史文章：公号&小程序 | 设计模式 | 并发&协程 ...

在stackoverflow 看到一个问题，Redis strings vs Redis hashes to represent JSON: efficiency?内容如下： I want to store a JSON payload into redis. There’s really 2 ways I can do this: One using a simple string keys and values. key:user, value:payload (the entire JSON blob which can be 100-200 KB) SET user:1 payload Using hashes HSET user:1 username “someone” HSET user:1 location “NY” HSET user:1 bio “STRING WITH OVER 100 lines” Keep in mind that if I use a hash, the value length isn’t predictable. They’re not all short such as the bio example above. Which is more memory efficient? Using string keys and values, or using a hash? ...

前几天写了《markdown 生成头条文章的一个思路》，周末就试了试。 先回顾一下思路，大致流程如下： 这里的三个关键点是： 提取code 把code 转换为html 把html 生成图片 code 替换成图片 第一个很简单，只有用正则表达式就可以解决： _fenced_code_block_re = re.compile(r''' (?:\n+|\A\n?) ^```\s*?([\w+-]+)?\s*?\n # opening fence, $1 = optional lang (.*?) # $2 = code block content ^```[ \t]*\n # closing fence ''', re.M | re.X | re.S) 这个正则来自 python-markdown2: https://github.com/trentm/python-markdown2 这个正则只匹配了 ``` 样式的代码，对于前边有四个空格的并没有做处理（也不想做处理，还是严格一点好）。 第二个也不麻烦，只需要把提取出的code 放到html 中，下面是一个html模板： <html> <head> <link rel="stylesheet" href="http://media.gusibi.mobi/highlight/static/styles/atom-one-dark.css"> <script src="http://media.gusibi.mobi/highlight/static/highlight.site.pack.js"></script> <script>hljs.initHighlightingOnLoad();</script> </head> <body style="width: 640px;"> <pre> <code class="{{.Language}}">{{.Code}}</code> </pre> </body> </html>` 这里有一个点是渲染html 页面的时候， 由于加载html 页面的工具都是get请求，这里我们需要先把code 数据保存起来。所以请求code 的html 页面分成了两步。 ...

最近在头条上写东西，遇到了一个比较烦的事情—编辑器不支持代码。这对于一个像我这样使用代码凑字数的人来说实在不是一个好的消息。但是等头条改进编辑器太遥远了，只能自己自足实现一个替代方案了–把代码替换成图片。 一段代码的时候，我随手截图，简单完成了； 两段代码的时候，我随手随手截图，也完成了； 三段代码的时候，我随手随手随手截图，强忍着完成了； 等我发现代码越来越多的时候，不能忍了。 懒惰是程序员的美德，不能再花费时间干这些事情了。我觉得要写个程序，把markdown 中的代码自动生成图片。 考虑了一下，大概需要做的工作是： 把markdown 中 “ ” 包换的代码提取出来（也可以使用工具先把markdown 转换成html 再解析html 取出code 把每一段code 分别生成图片 把图片对应的代码替换掉 想想还是很简单的。那就开始吧。 但是到第二步的时候遇到了问题，code 如何生成图片，生成什么样的图片？ 首先code 需要保持原有的样式，如果能高亮那就更好了（嗯，高亮 生成图片的时候是把code 作为文字使用PIL（我使用python）写在背景上么，图片大小是多少，高亮怎么实现 算了，还是先把code 生成html，然后截取html页面吧。（这样html 还能使用 highlight.js 来实现高亮） 如何动态生成包含code 的html 页面呢？ 如何把截取html 页面呢？ 动态生成包含code 的html 页面有两个思路： 使用post 请求，把code 写入数据库（或者文件），然后返回id，再使用id GET 请求获取页面（需要存储，两次请求） 压缩code，把code 作为url参数，使用GET请求获取页面（可能会造成url太长的错误） 那如何截取html呢？ 如果是python，可以使用pyqt，渲染html页面，截取webview。 如果使用node，可以使用 html2canvas。 大致流程如下： 哎，这一篇没有代码，就凑不了多少字。 最后，感谢女朋友支持和包容，比❤️ 也可以在公号输入以下关键字获取历史文章：公号&小程序 | 设计模式 | 并发&协程 内推时间

面向DynamoDB的NoSQL设计 关系数据库设计和NoSQL之间的差异 关系型数据库可以灵活的查询数据，但是成本较高，高流量无法扩展 RDBMS 设计灵活，可以随时修改 NoSQL查询方式有限 需要对架构进行专门设计，以尽可能的加快查询速度。数据结构和需求高度相关，需要特制。 NoSQL设计的两个关键概念 需要先了解业务问题和应用程序的使用案例，然后再开始设计 应保留尽可能少的表。 了解NoSQL设计 三个基本属性 数据大小 了解一次存储和请求的数据量将有助于确定对数据进行分区的最有效方法。 数据形状 NoSQL 数据库不会在处理查询时重塑数据（如 RDBMS 系统所做的一样），而是整理数据以便数据在数据库中的形状与查询内容对应。这是加快速度并增强可扩展性的一个关键因素 数据速度 DynamoDB 通过增加可用于处理查询的物理分区的数量并通过跨这些分区有效分发数据来进行扩展。预先了解峰值查询负载可能有助于确定数据分区方式，从而最高效地使用 I/O 容量。 性能的一般准则 将相关数据放在一起 将相关数据集中放置到一个位置。将相关数据保留在最近位置会对成本和性能产生重大影响。 不是跨多个表分发相关数据项目，而是在 NoSQL 系统中尽可能紧密地保留相关项目。 作为一般规则，应在 DynamoDB 应用程序中保留尽可能少的表。 只需要一个表， 例外是涉及大量时间序列数据的情况或具有明显不同的访问模式的数据集 — 但这些都是例外。具有反向索引的单个表通常可启用简单查询来创建和检索应用程序所需的复杂层次数据结构。 使用排序顺序 可将相关项目组织起来并进行有效查询，前提是它们的键设计可促使它们一起排序 分发查询 您应该设计数据键以跨尽可能多的分区均匀分发流量，从而避免“热点”。 使用全局二级索引 通过创建特定的全局二级索引，可启用主表支持的查询以外的查询 设计并高效使用分区键的最佳实践 项目主键可以是仅分区键 也可以是分区键+排序键 高效使用突增容量 DynamoDB 当前可将未使用的读取和写入容量保留最多五分钟 (300 秒) 当读取或写入突增导致容量不足时使用。 DynamoDB适应性容量 DynamoDB 适应性容量 允许您的应用程序继续不受限地对热分区进行读写操作，前提是流量未超出表的配置的总容量或分区最大容量。自适应容量的工作原理是，自动增加分区的吞吐量容量来接收更多流量 示例表配置了 400 个写入容量单位 (WCU)，这些容量单位均匀分布在 4 个分区中，每个分区每秒可以接收最多 100 个 WCU。分区 1、2 和 3 每秒接收的写入流量为 50 个 WCU。分区 4 每秒接收 150 个 WCU。此热分区可以在接受写入流量的同时仍具有未利用的突增容量，但是，它最终会限制每秒超过 100 个 WCU 的流量。 ...