sqlflow icon indicating copy to clipboard operation
sqlflow copied to clipboard

Published 20 hours ago • verified publisher icon sql-machine-learning

Document structure refine for our official website

Open lhw362950217 opened this issue 4 years ago • 10 comments

官网文档结构：

  1. 快速开始 / Quick Start (描述体验 SQLFlow Playground的流程，添加指向教程、语法、模型文档的链接)

    1. 云端体验 / Cloud Playground

  2. 部署 / Deployment

    1. 本地快速安装 / Local Try Out
    2. 在Kubernetes集群上部署 / Deploy on Kubernetes Cluster（需介绍如何使用各种数据库）
    3. 高可用部署 / High Availability
    4. 最佳性能部署 / Performance
    5. 连接MySQL、Hive、Maxcompute等多种数据库

  3. 案例教程 / Tutorials：

    1. 泰坦尼克号生存预测
    2. 信用卡欺诈检测
    3. 点击率预估
    4. 汽车价格预测及模型解释
    5. 苹果股价预测（时序特征提取）
    6. 优化问题求解

  4. 语法说明 / Grammar Reference

    1. 训练 / Training
    2. 预测 / Predicting
    3. 模型评估 / Evaluation
    4. 模型解释 / Model Explain
    5. 自定义Runnable / Customized Runnable
    6. 运筹规划

  5. 模型说明 / Model Reference

    1. 有监督学习
      1. Tensorflow Estimator 模型
      2. Tensorflow Keras 模型
      3. XGBoost 模型
      4. GCN 模型
    2. 无监督模型？

  6. 自定义模型

  7. 自定义Runnable

  8. 参与贡献SQLFlow

lhw362950217 avatar Oct 12 '20 03:10 lhw362950217

  1. 快速开始 / Quick Start
    1. 云端体验 / Cloud Playground
    2. 本地快速安装 / Local Try Out
  2. 部署 / Deployment
    1. 在Kubernetes集群上部署 / Deploy on Kubernetes Cluster
    2. 高可用部署 / High Availability
    3. 最佳性能部署 / Performance
  3. 案例教程 / Tutorials
    1. ...
  4. 语法说明 / Grammar Reference
    1. 训练 / Training
    2. 预测 / Predicting
    3. 模型评估 / Evaluation
    4. 模型解释 / Model Explain
    5. 自定义处理 / Self-defined Runnable
  5. 模型说明
    1. ...
  6. 自定义模型
  7. 自定义处理（名字待讨论）
  8. 参与贡献SQLFlow

设计文档不需要放在官网了应该。用户不太关心，可以只放在Github.

typhoonzero avatar Oct 12 '20 03:10 typhoonzero

  1. 快速开始 / Quick Start

    1. 云端体验 / Cloud Playground
    2. 本地快速安装 / Local Try Out

ii 这里是指VM里安装吗？

  1. 部署 / Deployment

    1. 在Kubernetes集群上部署 / Deploy on Kubernetes Cluster
    2. 高可用部署 / High Availability
    3. 最佳性能部署 / Performance

感觉 ii 和 iii 目前没有什么内容好写？

  1. 案例教程 / Tutorials

    1. ...

  2. 语法说明 / Grammar Reference

    1. 训练 / Training
    2. 预测 / Predicting
    3. 模型评估 / Evaluation
    4. 模型解释 / Model Explain
    5. 自定义处理 / Self-defined Runnable

Self-defined -> Customized Runnable ?

  1. 模型说明

    1. ...

  2. 自定义模型

  3. 自定义处理（名字待讨论）

  4. 参与贡献SQLFlow

6,7,8 是否可以放到一个大目录”开发者指南/Developer Guide“下？

设计文档不需要放在官网了应该。用户不太关心，可以只放在Github.

lhw362950217 avatar Oct 12 '20 03:10 lhw362950217

ii 这里是指VM里安装吗？

是的。

感觉 ii 和 iii 目前没有什么内容好写？

有的。

Self-defined -> Customized Runnable ?

同意。

6,7,8 是否可以放到一个大目录”开发者指南/Developer Guide“下？

不行。开发者指南，顾名思义是开发SQLFlow的指南，很难直接联想到是贡献模型，需要分开。

typhoonzero avatar Oct 12 '20 04:10 typhoonzero

“快速开始”里的“部署”是否可以合并在一起呢，比如叫“安装指南”？一般来说，用户希望本地能安装起来，然后再考虑集群安装。而集群部署其实也属于安装的一部分，感觉不太适合单独作为一个章节。

“安装指南”里包含3部分：

  1. 安装指南 / Install Guide
    1. 云端快速体验 / Cloud Playground
    2. 本地快速安装 / Local Try Out
    3. Kubernetes集群安装 / Deployment on Kubernetes Cluster
      1. 高可用部署 / High Availability
      2. 最佳性能部署 / Performance

sneaxiy avatar Oct 12 '20 09:10 sneaxiy

  1. 语法说明 / Grammar Reference
    1. 训练 / Training
    2. 预测 / Predicting
    3. 模型评估 / Evaluation
    4. 模型解释 / Model Explain
    5. 自定义处理 / Self-defined Runnable

最后加上“运筹规划”。

sneaxiy avatar Oct 12 '20 09:10 sneaxiy

“快速开始”里的“部署”是否可以合并在一起呢，比如叫“安装指南”？一般来说，用户希望本地能安装起来，然后再考虑集群安装。而集群部署其实也属于安装的一部分，感觉不太适合单独作为一个章节。

“安装指南”里包含3部分：

  1. 安装指南 / Install Guide

    1. 云端快速体验 / Cloud Playground

    2. 本地快速安装 / Local Try Out

    3. Kubernetes集群安装 / Deployment on Kubernetes Cluster

      1. 高可用部署 / High Availability
      2. 最佳性能部署 / Performance

快速开始是希望让用户最好不安装就能体验SQLFlow的能力，所以把云端体验放进去了。体验之后如果有兴趣的话可以在本地VM安一个，作为体验或开发的环境。

部署主要是讲线上环境如何部署哈

lhw362950217 avatar Oct 12 '20 09:10 lhw362950217

“快速开始”里的“部署”是否可以合并在一起呢，比如叫“安装指南”？一般来说，用户希望本地能安装起来，然后再考虑集群安装。而集群部署其实也属于安装的一部分，感觉不太适合单独作为一个章节。 “安装指南”里包含3部分：

  1. 安装指南 / Install Guide

    1. 云端快速体验 / Cloud Playground

    2. 本地快速安装 / Local Try Out

    3. Kubernetes集群安装 / Deployment on Kubernetes Cluster

      1. 高可用部署 / High Availability
      2. 最佳性能部署 / Performance

快速开始是希望让用户最好不安装就能体验SQLFlow的能力，所以把云端体验放进去了。体验之后如果有兴趣的话可以在本地VM安一个，作为体验或开发的环境。

部署主要是讲线上环境如何部署哈

那是否可以考虑下把“快速体验/Quick start”单独作为一个章节，本地安装和集群部署统称为“安装指南/Install Guide”？

sneaxiy avatar Oct 12 '20 09:10 sneaxiy

在Kubernetes集群上部署 / Deploy on Kubernetes Cluster（需介绍如何使用各种数据库）

链接各种数据库是不是可以单独一个章节？不同部署方式和不同数据库应该是正交的。

高可用部署 / High Availability 最佳性能部署 / Performance

最佳性能是指什么性能呢？SQLFlow server 还是作业的性能呢？

Yancey1989 avatar Oct 12 '20 09:10 Yancey1989

在Kubernetes集群上部署 / Deploy on Kubernetes Cluster（需介绍如何使用各种数据库）

链接各种数据库是不是可以单独一个章节？不同部署方式和不同数据库应该是正交的。

Agreed

高可用部署 / High Availability 最佳性能部署 / Performance

最佳性能是指什么性能呢？SQLFlow server 还是作业的性能呢？

指SQLFlow server和作业整体的高性能部署的文档，目前只是站位，还没想好具体内容

lhw362950217 avatar Oct 14 '20 06:10 lhw362950217

最佳性能是指什么性能呢？SQLFlow server 还是作业的性能呢？

包括SQLFlow 部署需要的怎么和database使用可以达到最佳性能，比如和Hive, MySQL 不能跨机房部署，Kubernetes集群必须有至少几个节点，pod之间网络通信带宽，如果是GPU集群，GPU集群之间的通信带宽等。

typhoonzero avatar Oct 14 '20 06:10 typhoonzero