You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@doris.apache.org by 41108453 <41...@qq.com.INVALID> on 2022/03/23 03:44:33 UTC
回复: [DISCUSS]Doris documentation discussion
For the developer-oriented part, we will open a single column on the official website with the new version: developer documentation, and put the current developer manual and Doris design documentation here
Jiafeng.Zhang
------------------ 原始邮件 ------------------
发件人: "dev" <lingmiao@apache.org>;
发送时间: 2022年3月23日(星期三) 上午10:37
收件人: "dev"<dev@doris.apache.org>;
主题: Re: [DISCUSS]Doris documentation discussion
In addition to the user-facing part, there needs to be a developer-facing
part ~
Ling Miao
陈明雨 <morningman@163.com> 于2022年3月23日周三 10:29写道:
> Nice work! Good to see that we can move one step forward to regonize the
> documents.
>
>
>
> There are two main types of documentation on the official website:
>
> 1. User-oriented documentation
>
> This kind of documentation needs to start from the user's perspective and
> guide the user to complete a specific scenario.
> For example, "Importing local files into Doris", or "How to design table
> structure and SQL for high concurrency scenarios".
>
>
>
>
> 2. Help manuals
>
> The help manual is a detailed introduction to the use of a specific
> function from the perspective of the function of the product.
> For example, the meaning of parameters, how to configure, etc.
>
>
>
>
> --
>
> 此致!Best Regards
> 陈明雨 Mingyu Chen
>
> Email:
> chenmingyu@apache.org
>
>
>
>
>
> At 2022-03-23 09:32:16, "41108453" <41108453@qq.com.INVALID> wrote:
> >Dear all,
> >
> >
> >
> >
> >For problems with the current documentation:
> >
> >
> >1. Lack of Get Started, allowing users to quickly experience Doris
> through a document.
> >2. The directory is not clear, users are inconvenient to use, and it is
> difficult to quickly find the documents they need
> >3. The function instruction part lacks the best practice for changing the
> function, and help, the user does not know where to check the corresponding
> help document when using it
> >4. The data import module is just a stack of functions, and there is no
> classification according to the actual data source, allowing users to
> choose and use according to their own data sources
> >
> >
> >In response to the above problems, I have reorganized the documents, as
> follows:
> >
> >
> >1. Add a quick start document to allow users to quickly experience Doris,
> Doris download, installation and deployment, table building, query,
> analysis, etc.
> >2. Re-divide the directory structure into 11 directories to make the
> entire directory structure clearer. Specifically, I will give a link below
> for everyone to discuss.
> >3. The content of each function will be rewritten. In addition to briefly
> explaining the principle of changing the function, 1-2 examples will be
> given for each function, so that users can use it quickly. The document
> does not list too many parameter explanations of this function. For
> specific function parameters and more help information, a link to the help
> document will be given at the end of the document. Users can go directly to
> the help document of this function. At the same time, it will give the best
> practice of this function, such as Stream load, which will give the most
> Optimal batch data volume, batch practice interval, etc.
> >4. Now user usage documents and management and maintenance documents are
> mixed together, and it is very inconvenient for users to find them. This
> time, they will be separated and divided into basic data operations,
> advanced use, and management manuals.
> >5. The original document lacked an introduction to the basic concepts of
> Doris and the Doris system architecture. This time, this part will be
> supplemented so that users can have a comprehensive understanding of the
> Doris system architecture through official documents.
> >6. The design document will be merged with the developer manual, and will
> be placed in a separate column with the new official website revision: the
> developer manual
> >7. The apache community will also be a separate column, not in the doris
> document
> >8. Doris users will also be separated into a separate column, not in the
> document
> >
> >
> >
> >
> >I have sorted out the general directory structure for everyone to
> discuss. For the time being, it is only in Chinese, and English is still
> being sorted out. For details, please refer to the following links:
> >http://123.56.118.34:8080/zh-CN
> >
> >
> >Brs,
> >Jiafeng.Zhang
> >Email:jiafengzheng@apache.org
>
Re: [DISCUSS]Doris documentation discussion
Posted by ling miao <li...@apache.org>.
Sounds great ~
Ling Miao
41108453 <41...@qq.com.invalid> 于2022年3月23日周三 11:44写道:
> For the developer-oriented part, we will open a single column on the
> official website with the new version: developer documentation, and put the
> current developer manual and Doris design documentation here
>
>
> Jiafeng.Zhang
>
>
>
>
> ------------------ 原始邮件 ------------------
> 发件人:
> "dev"
> <
> lingmiao@apache.org>;
> 发送时间: 2022年3月23日(星期三) 上午10:37
> 收件人: "dev"<dev@doris.apache.org>;
>
> 主题: Re: [DISCUSS]Doris documentation discussion
>
>
>
> In addition to the user-facing part, there needs to be a developer-facing
> part ~
>
> Ling Miao
>
> 陈明雨 <morningman@163.com> 于2022年3月23日周三 10:29写道:
>
> > Nice work! Good to see that we can move one step forward to regonize
> the
> > documents.
> >
> >
> >
> > There are two main types of documentation on the official website:
> >
> > 1. User-oriented documentation
> >
> > This kind of documentation needs to start from the user's perspective
> and
> > guide the user to complete a specific scenario.
> > For example, "Importing local files into Doris", or "How to design
> table
> > structure and SQL for high concurrency scenarios".
> >
> >
> >
> >
> > 2. Help manuals
> >
> > The help manual is a detailed introduction to the use of a specific
> > function from the perspective of the function of the product.
> > For example, the meaning of parameters, how to configure, etc.
> >
> >
> >
> >
> > --
> >
> > 此致!Best Regards
> > 陈明雨 Mingyu Chen
> >
> > Email:
> > chenmingyu@apache.org
> >
> >
> >
> >
> >
> > At 2022-03-23 09:32:16, "41108453" <41108453@qq.com.INVALID>
> wrote:
> > >Dear all,
> > >
> > >
> > >
> > >
> > >For problems with the current documentation:
> > >
> > >
> > >1. Lack of Get Started, allowing users to quickly experience Doris
> > through a document.
> > >2. The directory is not clear, users are inconvenient to use, and
> it is
> > difficult to quickly find the documents they need
> > >3. The function instruction part lacks the best practice for
> changing the
> > function, and help, the user does not know where to check the
> corresponding
> > help document when using it
> > >4. The data import module is just a stack of functions, and there
> is no
> > classification according to the actual data source, allowing users to
> > choose and use according to their own data sources
> > >
> > >
> > >In response to the above problems, I have reorganized the
> documents, as
> > follows:
> > >
> > >
> > >1. Add a quick start document to allow users to quickly
> experience Doris,
> > Doris download, installation and deployment, table building, query,
> > analysis, etc.
> > >2. Re-divide the directory structure into 11 directories to make
> the
> > entire directory structure clearer. Specifically, I will give a link
> below
> > for everyone to discuss.
> > >3. The content of each function will be rewritten. In addition to
> briefly
> > explaining the principle of changing the function, 1-2 examples will
> be
> > given for each function, so that users can use it quickly. The
> document
> > does not list too many parameter explanations of this function. For
> > specific function parameters and more help information, a link to the
> help
> > document will be given at the end of the document. Users can go
> directly to
> > the help document of this function. At the same time, it will give
> the best
> > practice of this function, such as Stream load, which will give the
> most
> > Optimal batch data volume, batch practice interval, etc.
> > >4. Now user usage documents and management and maintenance
> documents are
> > mixed together, and it is very inconvenient for users to find them.
> This
> > time, they will be separated and divided into basic data operations,
> > advanced use, and management manuals.
> > >5. The original document lacked an introduction to the basic
> concepts of
> > Doris and the Doris system architecture. This time, this part will be
> > supplemented so that users can have a comprehensive understanding of
> the
> > Doris system architecture through official documents.
> > >6. The design document will be merged with the developer manual,
> and will
> > be placed in a separate column with the new official website
> revision: the
> > developer manual
> > >7. The apache community will also be a separate column, not in
> the doris
> > document
> > >8. Doris users will also be separated into a separate column, not
> in the
> > document
> > >
> > >
> > >
> > >
> > >I have sorted out the general directory structure for everyone to
> > discuss. For the time being, it is only in Chinese, and English is
> still
> > being sorted out. For details, please refer to the following links:
> > >http://123.56.118.34:8080/zh-CN
> > >
> > >
> > >Brs,
> > >Jiafeng.Zhang
> > >Email:jiafengzheng@apache.org
> >