Merge remote-tracking branch 'origin/master' into experience

Author: dfounderliu

docs/en/yaml.md

@@ -84,6 +84,7 @@ functions:
 # stageName: release
 # serviceId:
 # httpMethod: ANY
+# integratedResponse: true
 # - cmq:
 # name: cmq_trigger
 # parameters:

docs/zh/README.md

@@ -4,7 +4,7 @@
 ## 前提条件
 在使用之前，请确保如下软件已经安装：
 - [Node.js](#node)（6.x或以上的版本）
-- [Serverless Framework CLI](#cli)（1.47.0或以上的版本）
+- [Serverless Framework CLI](#cli)（1.57.0或以上的版本）
 
 如果这些条件已经满足，您可以跳过此步骤，直接 [开始部署一个服务](#buzhou)。
 
@@ -57,9 +57,6 @@ $ cd my-service
 $ npm install
 ```
 
-#### 配置账户信息
-参考 [配置账号](./配置账号.md) 文档。
-
 #### 配置触发器
 云函数需要通过触发器的事件调用进行触发，因此可以在`serverless.yml`中增加对触发器的配置，以 API 网关触发器为例，配置如下：
 ```yaml
@@ -68,13 +65,13 @@ service: my-service # service name
 provider: # provider information
  name: tencent
  runtime: Nodejs8.9
- credentials: ~/credentials #密钥配置需要和上一步配置的账户信息文件路径一致
+ credentials: ~/credentials #如不使用二维码一键登录，密钥字段需要和credentials文件路径一致
 
 plugins:
  - serverless-tencent-scf
 
 functions:
- hello: # function name
+ hello_world: # function name
  handler: index.main_handler
  runtime: Nodejs8.9
  events:
@@ -86,11 +83,16 @@ functions:
  httpMethod: ANY
 ```
 
+> 注，Serverless Framework会为控制台中实际部署的函数增加前缀组成函数名称，前缀规范为`service-stage-function`，默认的stage为`dev`。以上述配置为例，配置文件中的函数名称`hello_world`在控制台中的函数名称对应为`my-service-dev-hello_world`。
+
 #### 部署服务
 通过该命令部署或更新您创建的函数和触发器，资源配置会和`serverless.yml`中保持一致。
 ```bash
 serverless deploy
 ```
+
+如您的账号未[登陆](https://cloud.tencent.com/login)或[注册](https://cloud.tencent.com/register)腾讯云，您可以在运行该命令后，直接用`微信`扫描命令中弹出的二维码，对云账户进行授权登陆和注册。
+
 更多部署详情参考 [部署服务](./部署服务.md) 文档。
 
 #### 测试服务
@@ -105,15 +107,15 @@ $ curl -X POST https://service-xxxx-1300000000.ap-guangzhou.apigateway.myqcloud.
 通过以下命令云端调用函数并且获得日志信息的返回。
 
 ```bash
-serverless invoke -f hello
+serverless invoke -f hello_world
 ```
 更多部署详情参考 [云端调用](./云端调用.md)。
 
 #### 获取函数日志
 
-单独开启一个命令行，通过如下命令，实时获取函数`hello`的云端调用日志信息。
+单独开启一个命令行，输入如下命令，再次云端调用函数，并实时获取函数`hello_world`的云端调用日志信息。
 ```bash
-serverless logs -f hello -t
+serverless logs -f hello_world -t
 ```
 
 #### 移除服务
@@ -122,3 +124,6 @@ serverless logs -f hello -t
 ```sh
 serverless remove
 ```
+
+#### 配置账户信息
+当前默认支持CLI扫描二维码登录，如您希望配置持久的环境变量/秘钥信息，也可以参考 [配置账号](./配置账号.md) 文档。

docs/zh/产品概述.md

@@ -1,12 +1,18 @@
-Serverless Framework 是业界最受欢迎的无服务器应用框架，开发者无需关心底层资源即可部署完整可用的 Serverless 应用架构。Serverless Framework 具有资源编排、自动伸缩、事件驱动等能力，覆盖编码 - 调试 - 测试 - 部署等全生命周期。帮助开发者通过联动云资源，迅速地构建 serverless 应用。
+Serverless Framework 是业界非常受欢迎的无服务器应用框架，开发者无需关心底层资源即可部署完整可用的 Serverless 应用架构。Serverless Framework 具有资源编排、自动伸缩、事件驱动等能力，覆盖编码、调试、测试、部署等全生命周期，帮助开发者通过联动云资源，迅速构建 Serverless 应用。
 
+Serverless Framework 是一个 标准化、组件化 的 Serverless 应用开发产品，如下图所示：
 
+![Serverless Framework架构图](https://main.qcloudimg.com/raw/2c5d24285f2ea19151635d0352dc2a20.png)
 
-## 主要功能
-
-### 应用级框架
+## 产品功能
+#### 应用级框架
 Serverless Framework 提供贴合应用场景的框架，开发者根据实际需求选择对应框架后，只需专注于业务逻辑的开发，无需关注底层资源。
 
-### 便捷部署
-开发者部署应用时，Serverless Framework 会根据应用特性，自动完成云函数，API 网关，COS 等基础资源的部署和配置。开发者无需再手动部署配置每一项基础资源。
+#### 便捷部署
+开发者部署应用时，Serverless Framework 会根据应用特性，自动完成云函数、API 网关、COS 等基础资源的部署和配置，无需再手动部署配置每一项基础资源。
 
+## 应用场景
+#### 一站式体验
+通过 Serverless Framework，您可以快速创建 Serverless 应用，并完成应用的调试和部署，监控已发布应用运行状态并快速排障。
+Serverless Framework 提供多种 Serverless 应用级别的组件，开发者无需关注 Serverless 应用底层资源，选择并下载符合自己业务场景的组件后，编写个性化的业务逻辑即可。
+![](https://main.qcloudimg.com/raw/f4f0af702e134982fd5ef068c31a070e.svg)

docs/zh/常见问题.md

@@ -5,6 +5,10 @@ Serverless Framework 是无服务器应用框架，提供将云函数 SCF ，API
 ### Serverless Framework 提供了哪些应用框架
 目前已提供 REST API 和 基础 website ，更多贴合实际应用场景的框架在持续输出中。
 
+### Serverless Framework 报错 "component" input is requires to run custom methods 怎么处理？
+运行Serverless Framework CLI时，如果yaml配置文件中默认引用了component组件，则需要保证文件夹之前为空，才可以正确运行component的安装命令。
+您可以尝试在一个空文件夹中重新运行`serverless create`命令，则不会再出现如下错误。
+
 ### 云函数执行超时怎么处理？
 
 超时客户端会直接断开连接并报错，建议控制函数执行时间，尽量不要把耗时长的操作放在客户端直接调用的云函数内。

docs/zh/配置账号.md

@@ -1,4 +1,19 @@
-如果您是首次使用云函数产品，需要前往控制台配置角色授权。
+# 微信扫码授权
+
+如您的账号未[登陆](https://cloud.tencent.com/login)或[注册](https://cloud.tencent.com/register)腾讯云，您可以在运行`serverless deploy`云端部署命令后，直接用`微信`扫描命令中弹出的二维码，对云账户进行授权登陆和注册。
+
+当前Serverless Framework将获取以下权限：
+- COS所有操作
+- SCF（云函数）全读写权限
+- TAG（标签）全读写权限
+- CAM（访问管理）查看角色权限
+- CAM（访问管理）创建角色权限
+- VPC（私有网络）只读权限
+- Monitor（云监控）只读权限
+
+# 账户秘钥配置授权
+
+如您希望配置持久的环境变量/秘钥信息，需要按如下步骤前往控制台配置角色授权。
 
 ## 前提条件