From 2ccb5209a085d314fdafc64dcb45af94f06321a3 Mon Sep 17 00:00:00 2001 From: Mingyu Chen Date: Sun, 20 Nov 2022 00:05:53 +0800 Subject: [PATCH] (improvement)[doc] add document version tag instruction (#14406) --- .../how-to-contribute/contribute-doc.md | 121 +++++++++++++++++- .../how-to-contribute/contribute-doc.md | 121 +++++++++++++++++- 2 files changed, 240 insertions(+), 2 deletions(-) diff --git a/docs/en/community/how-to-contribute/contribute-doc.md b/docs/en/community/how-to-contribute/contribute-doc.md index 4429171007..541d13d77e 100644 --- a/docs/en/community/how-to-contribute/contribute-doc.md +++ b/docs/en/community/how-to-contribute/contribute-doc.md @@ -310,4 +310,123 @@ Directory structure description: 3. Pictures - All images are in the `static/images` directory \ No newline at end of file + All images are in the `static/images` directory + +## Multiple Versions + +Website documentation supports version tagging via html tags. You can use the `` tag to mark which version a section of content in the document started from, or which version it was removed from. + +### Parameters introduction + +| parameter | description | value | +|---|---|---| +| since | supported from this version | version number | +| deprecated | removed from this version | version number | +| comment | Comment | | +| type | There are default and inline styles | No value is passed to indicate the default style, and inline is passed to indicate the inline style | + +Note: There must be blank lines before and after the `` tag to avoid abnormal style rendering. + +### Single Tag + +``` + + + +Apache Doris was first born as Palo project for Baidu's ad reporting business, + officially open-sourced in 2017, donated by Baidu to the Apache Foundation + for incubation in July 2018, and then incubated and operated by members of + the incubator project management committee under the guidance of + Apache mentors. Currently, the Apache Doris community has gathered + more than 300 contributors from nearly 100 companies in different + industries, and the number of active contributors is close to 100 per month. + Apache Doris has graduated from Apache incubator successfully and + become a Top-Level Project in June 2022. + + + +``` + +Rendering style: + + + +Apache Doris was first born as Palo project for Baidu's ad reporting business, + officially open-sourced in 2017, donated by Baidu to the Apache Foundation + for incubation in July 2018, and then incubated and operated by members of + the incubator project management committee under the guidance of + Apache mentors. Currently, the Apache Doris community has gathered + more than 300 contributors from nearly 100 companies in different + industries, and the number of active contributors is close to 100 per month. + Apache Doris has graduated from Apache incubator successfully and + become a Top-Level Project in June 2022. + + + +### Multi Tag + +``` + + + +# Usage Scenarios + +As shown in the figure below, after various data integration and processing, the data sources are usually stored in the real-time data warehouse Doris and the offline data lake or data warehouse (in Apache Hive, Apache Iceberg or Apache Hudi). +![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/sekvbs5ih5rb16wz6n9k.png) + +Apache Doris is widely used in the following scenarios: + + + +``` + +Rendering style: + + + +# Usage Scenarios + +As shown in the figure below, after various data integration and processing, the data sources are usually stored in the real-time data warehouse Doris and the offline data lake or data warehouse (in Apache Hive, Apache Iceberg or Apache Hudi). +![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/sekvbs5ih5rb16wz6n9k.png) + +Apache Doris is widely used in the following scenarios: + + + +### Comments + +``` + + + +- Frontend（FE）: It is mainly responsible for user request access, query parsing and planning, management of metadata, and node management-related work. +- Backend（BE）: It is mainly responsible for data storage and query plan execution. + +Both types of processes are horizontally scalable, and a single cluster can support up to hundreds of machines and tens of petabytes of storage capacity. And these two types of processes guarantee high availability of services and high reliability of data through consistency protocols. This highly integrated architecture design greatly reduces the operation and maintenance cost of a distributed system. + + + +``` + +Rendering style: + + + +- Frontend（FE）: It is mainly responsible for user request access, query parsing and planning, management of metadata, and node management-related work. +- Backend（BE）: It is mainly responsible for data storage and query plan execution. + +Both types of processes are horizontally scalable, and a single cluster can support up to hundreds of machines and tens of petabytes of storage capacity. And these two types of processes guarantee high availability of services and high reliability of data through consistency protocols. This highly integrated architecture design greatly reduces the operation and maintenance cost of a distributed system. + + + +### Inline Tag + +``` +In terms of the storage engine, Doris uses columnar storage to encode and compress and read data by column, enabling a very high compression ratio while reducing a large number of scans of non-relevant data, thus making more efficient use of IO and CPU resources. +``` + +渲染样式： + +In terms of the storage engine, Doris uses columnar storage to encode and compress and read data by column, enabling a very high compression ratio while reducing a large number of scans of non-relevant data, thus making more efficient use of IO and CPU resources. + + diff --git a/docs/zh-CN/community/how-to-contribute/contribute-doc.md b/docs/zh-CN/community/how-to-contribute/contribute-doc.md index 098e18f0bc..b0b38ae6f6 100644 --- a/docs/zh-CN/community/how-to-contribute/contribute-doc.md +++ b/docs/zh-CN/community/how-to-contribute/contribute-doc.md @@ -309,4 +309,123 @@ under the License. 4. 图片 - 所有图片都在 `static/images `目录下面 \ No newline at end of file + 所有图片都在 `static/images `目录下面 + +## 文档多版本 + +网站文档支持通过 html 标签标记版本。可以通过 `` 标签标记文档中的某段内容是从哪个版本开始的，或者从哪个版本移除。 + +### 参数介绍 + +| 参数 | 说明 | 值 | +|---|---|---| +| since | 从该版本支持 | 版本号 | +| deprecated | 从该版本移除 | 版本号 | +| comment | 注释 | | +| type | 有默认和行内两种样式 | 不传值表示默认样式，传inline表示行内样式 | + +注意：`` 标签前后要有空行，避免样式渲染异常。 + +### 单标签 + +``` + + + +Apache Doris was first born as Palo project for Baidu's ad reporting business, + officially open-sourced in 2017, donated by Baidu to the Apache Foundation + for incubation in July 2018, and then incubated and operated by members of + the incubator project management committee under the guidance of + Apache mentors. Currently, the Apache Doris community has gathered + more than 300 contributors from nearly 100 companies in different + industries, and the number of active contributors is close to 100 per month. + Apache Doris has graduated from Apache incubator successfully and + become a Top-Level Project in June 2022. + + + +``` + +渲染样式： + + + +Apache Doris was first born as Palo project for Baidu's ad reporting business, + officially open-sourced in 2017, donated by Baidu to the Apache Foundation + for incubation in July 2018, and then incubated and operated by members of + the incubator project management committee under the guidance of + Apache mentors. Currently, the Apache Doris community has gathered + more than 300 contributors from nearly 100 companies in different + industries, and the number of active contributors is close to 100 per month. + Apache Doris has graduated from Apache incubator successfully and + become a Top-Level Project in June 2022. + + + +### 多标签 + +``` + + + +# Usage Scenarios + +As shown in the figure below, after various data integration and processing, the data sources are usually stored in the real-time data warehouse Doris and the offline data lake or data warehouse (in Apache Hive, Apache Iceberg or Apache Hudi). +![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/sekvbs5ih5rb16wz6n9k.png) + +Apache Doris is widely used in the following scenarios: + + + +``` + +渲染样式： + + + +# Usage Scenarios + +As shown in the figure below, after various data integration and processing, the data sources are usually stored in the real-time data warehouse Doris and the offline data lake or data warehouse (in Apache Hive, Apache Iceberg or Apache Hudi). +![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/sekvbs5ih5rb16wz6n9k.png) + +Apache Doris is widely used in the following scenarios: + + + +### 包含注释 + +``` + + + +- Frontend（FE）: It is mainly responsible for user request access, query parsing and planning, management of metadata, and node management-related work. +- Backend（BE）: It is mainly responsible for data storage and query plan execution. + +Both types of processes are horizontally scalable, and a single cluster can support up to hundreds of machines and tens of petabytes of storage capacity. And these two types of processes guarantee high availability of services and high reliability of data through consistency protocols. This highly integrated architecture design greatly reduces the operation and maintenance cost of a distributed system. + + + +``` + +渲染样式： + + + +- Frontend（FE）: It is mainly responsible for user request access, query parsing and planning, management of metadata, and node management-related work. +- Backend（BE）: It is mainly responsible for data storage and query plan execution. + +Both types of processes are horizontally scalable, and a single cluster can support up to hundreds of machines and tens of petabytes of storage capacity. And these two types of processes guarantee high availability of services and high reliability of data through consistency protocols. This highly integrated architecture design greatly reduces the operation and maintenance cost of a distributed system. + + + +### 行内标签 + +``` +In terms of the storage engine, Doris uses columnar storage to encode and compress and read data by column, enabling a very high compression ratio while reducing a large number of scans of non-relevant data, thus making more efficient use of IO and CPU resources. +``` + +渲染样式： + +In terms of the storage engine, Doris uses columnar storage to encode and compress and read data by column, enabling a very high compression ratio while reducing a large number of scans of non-relevant data, thus making more efficient use of IO and CPU resources. + +