根据REST APIs的成熟度模型 ,此规范关注的是Level 2的APIs.  1 设计指南 HTTP APIs主要由四部分组成:HTTP,URL,资源,资源的表述(JSON).资源的表述格式通常都采用JSON,故而后面就使用JSON代指资源的表述.根据这些组成部分,按照以下3个步骤设计APIs: 基于资源设计APIs. 基于URL标识资源. 基于JSON和HTTP操作URL标识的资源. 1.1 基于资源设计API 设计HTTP APIs的首要任务是识别出业务领域中存在的资源.资源是对服务端提…

ASIC设计-终极指南 ASIC Design – The Ultimate Guide ASIC设计-终极指南 ASICs代表特定于应用的集成电路,指的是针对特定应用而设计的半导体解决方案,与其他解决方案(如现场可编程门阵列(fpga))不同,现场可编程门阵列(fpga)可多次编程以执行不同的功能.ASIC有时也被称为SoC(片上系统). ASIC的设计之旅是一条漫长而曲折的道路,它将你从一个概念带到一个工作的硅.虽然最终产品通常非常小(以平方毫米为单位),但整个过程非常有趣,充满了挑战和权衡…

前言 本文摘自Google JavaScript编码规范指南,截取了其中比较容易理解与遵循的点作为团队的JavaScript编码规范. JavaScript 语言规范 变量 声明变量必须加上 var 关键字.     当你没有写 var, 变量就会暴露在全局上下文中, 这样很可能会和现有变量冲突. 另外, 如果没有加上, 很难明确该变量的作用域是什么, 变量也很可能像在局部作用域中, 很轻易地泄漏到 Document 或者 Window 中, 所以务必用 var 去声明变量. 常量     常量…

atitit.api设计 方法 指南 手册 v2 q929.docx atitit.api设计原则与方法 1. 归一化(锤子钉子理论)1 1.1. 链式方法2 1.2. 规则5:建立返回值类型2 1.3. 参数接收 JSON 对象2 1.4. 参数默认值2 1.5. 命名参数 support by map2 1.6.  处理类型 类型自动转换4 1.7.  处理 undefined null  empty5 1.8. .使用结构化语法5 1.9. 设置和获取操作,可以合二为一:方法越多,文档可能…

Markdown 编写规范指南 简介: Markdown的目标是实现「易读易写」,成为一种适用于网络的「书写语言」. 一份使用Markdown格式撰写的文件可以直接以纯文本发布,它的最大灵感来源其实是纯文本电子邮件的格式. Markdown的语法由一些符号所组成,其作用一目了然. 比如:在文字两旁加上星号,看起来就像强调. Markdown兼容HTML语法并且会将<和&等符号进行自动转换,这项特性可以让我们很容易地用Markdown写HTML code. 目录 基础语法 标题 # 这是 &l…

纽约时报 移动团队 Objective-C 规范指南 这份规范指南概括了纽约时报 iOS 团队的代码约定. 介绍 关于这个编程语言的所有规范,如果这里没有写到,那就在苹果的文档里: • Objective-C 编程语言 • Cocoa 基本原理指南 • Cocoa 编码指南 • iOS 应用编程指南 目录 • 点语法 • 间距 • 条件判断 • 三目运算符 • 错误处理 • 方法 • 变量 • 命名 • 注释 • Init 和 Dealloc • 字面量 • CGRect 函数 • 常量 • 枚…

最全面的 Android 编码规范指南 本文word文档下载地址:http://pan.baidu.com/s/1bXT75O 1. 前言 这份文档参考了 Google Java 编程风格规范和 Google 官方 Android 编码风格规范.该文档仅供参考,只要形成一个统一的风格,见量知其意就可. 1.1 术语说明 在本文档中,除非另有说明: 术语 class 可表示一个普通类,枚举类,接口或是annotation类型(@interface) 术语 comment 只用来指代实现的注释(im…

Google HTML&CSS规范指南 翻译自原文 目录 Google HTML&CSS规范指南 1. 背景 2. 通用 2.1 通用样式规则 2.1.1 协议 2.2 通用格式规则 2.2.1 缩进 2.3 通用元规则 2.3.1 编码 2.3.2 注释 2.3.3 操作项 3. HTML 3.1 HTML样式规则 3.1.1 文档类型 3.1.2 HMTL有效性 3.1.3 语义化 3.1.4 为多媒体内容留下挽救方案 3.1.5 业务分离 3.1.6 实体引用 3.1.7 可选的标签…

架构就像是一场进化史,根据不同时期的需求,演变出不同的架构,车轮滚滚,到今天,移动端框架百花齐放,让人目不暇接.但是其中的本质是磨灭不了的,换言之根本没有磨灭而是隐藏到了人们所看不到的地方,但是依旧发挥着不可或缺的作用. 为什么需要架构? 一个Activity走天下,包含各种模块和功能 臃肿类太多 不同功能,不同层次拎不清楚,混合在一起 重复代码太多,复用性为差 无法协作开发, 耦合严重,bug太多 等等 当我们新进一个公司,接受别人的项目的时候,基本都会说句MMP,SHI一样的代码啊,啥玩意啊…

转自:https://wsgzao.github.io/post/git/ 前言 在2005年的某一天,Linux之父Linus Torvalds 发布了他的又一个里程碑作品——Git.它的出现改变了软件开发流程,大大地提高了开发流畅度,直到现在仍十分流行,完全没有衰退的迹象.其实一般情况下,只需要掌握git的几个常用命令即可,但是在使用的过程中难免会遇到各种复杂的需求,这时候经常需要搜索,非常麻烦,故总结了一下自己平常会用到的git操作.本文根据团队实践记录Git入门指南和Git常用命令,文章…