[DSIP-2][Doc] Refactor the document

[zhongjiajie]

Description

For now, we documentation is not easy enough to read and maintain. I think documentation is also an important for OSS, it would be

General

• Sperate user_muanl/user_manal to multiple file with different level. Simply refactor document for DolphinScheduler 2.0 dolphinscheduler-website#453
• Add directory for our image file, start this task until all we markdown document is done.
• Find a way to use codebase repo directory icon files instead of copy-paste

Content

DRY

• remove duplicate content in the document, for example in installation we have duplicate download mysql dependent
• Many parameters of task have same definition, find a way to handle it. maybe we could see what github/doc do, https://github.com/github/docs

Missing document

• Chinese translation for ambari integration. @lukairui Chinese translation for ambari integration.  dolphinscheduler-website#494 Our community going to drop support of Apache Ambari in the further, so we do not need this anymore.
• How to contribute to our document, including dev and older doc.
• [Feature][doc] Add DSIP to documentation and issue template #6611
• 🔥 Missing Task: we missing some of our tasks in doc
  • SQOOP
  • condition. Simply refactor document for DolphinScheduler 2.0 dolphinscheduler-website#453
  • switch. [Feature][Doc] Add Task type switch #6561
  • waterdrop
  • pigeon. Simply refactor document for DolphinScheduler 2.0 dolphinscheduler-website#453
  • Task conditions screenshot add condition task img dolphinscheduler-website#461
• 🔥 Missing alert plugin
  • Alert plugin dingtalk add DingTalk alert plugin documentation dolphinscheduler-website#650
  • Alert plugin email
  • Alert plugin feishu
  • Alert plugin http
  • Alert plugin script
  • Alert plugin slack
  • Alert plugin wechat
• 🔥 Missing datasource plugin
  • Alert plugin clickhouse
  • Alert plugin db2
  • Alert plugin oracle
  • Alert plugin sqlserver
• Inside DolphinScheduler
  • How master node run
  • How worker node run
  • How master and worker community, and task lifecycle
• DolphinScheduler plugins development
• DolphinScheduler API
  • API docs and example, provider curl command line would be better.

To be classify

• user_doc/globalParam Move dev doc from docs to development dolphinscheduler-website#472
• All the spi document for develpment. [Feature][Doc] Move SPI documentation from docs to develpment #6577
• Unify dev-run and dev-quick-start Move dev doc from docs to development dolphinscheduler-website#472

To be update

• For now, task name much unify in the project
• introduction.md
• 🔥 Installation Refactor installation and add alert sub menu dolphinscheduler-website#465
• 🔥 Task Usage: we should add basic usage, example, notict about tasks
  • [Feature][Document] Add example and notice about task type Shell #8016
  • [Feature][Document] Add example and notice about task type SubProcess #8017
  • [Feature][Document] Add example and notice about task type Dependent #8018
  • [Feature][Document] Add example and notice about task type Stored Procedure #8019
  • [Feature][Document] Add example and notice about task type SQL #8020
  • [Feature][Document] Add example and notice about task type Spark #8021
  • [Feature][Document] Add example and notice about task type MapReduce #8022
  • [Feature][Document] Add example and notice about task type Python #8023
  • [Feature][Document] Add example and notice about task type Flink #8024
  • [Feature][Document] Add example and notice about task type HTTP #8025
  • [Feature][Document] Add example and notice about task type DataX #8026
  • [Feature][Document] Add example and notice about task type Pigeon #8027
  • [Feature][Document] Add example and notice about task type Conditions #8028
  • [Feature][Document] Add example and notice about task type Switch #8029
  • [Feature][Document] Add example and notice about task type SQOOP #8030
  • [Feature][Document] Add example and notice about task type seatunnel #8031
• Picture in English doc have Chinese content
  • design，[Bug] [Doc] Picture in designe EN doc have ZH content #7496
• architecture-design
  • Task queue. questions on architecture-design.md of 1.3.9 #7835
  • Architecture diagram. it seems that architecture diagram in the official website didn't update correspondingly #7306
• [Document] Upgrade 2.0 and dev branch screenshot to laster #7870

Syntax

• Use markdown table syntax instead of html table syntax <table>
• Find a better way to show our picture, for now it use html syntax in markdown file. I find our it can be show use markdown image syntax, such as this line

CI

• Add markdown link for our document
• Add chinese/english spelling ci for our doc
• Add document preview generation for each PR, example Add testing for docs in CI sqlfluff/sqlfluff#808 (comment) . I think it really important to reduce doc build error, such as this PR Correct dev leading page url wrong dolphinscheduler-website#454, we get error dev leading page url make all our document error.
• Add doc style check for our documentation, inspired by 1.3.9 doc-Add stand-alone component description dolphinscheduler-website#463 (comment). maybe we could use https://github.com/tidb-incubator/zh.md

[github-actions]

Hi:

• Thank you for your feedback, we have received your issue, Please wait patiently for a reply.
• In order for us to understand your request as soon as possible, please provide detailed information、version or pictures.
• If you haven't received a reply for a long time, you can subscribe to the developer's email，Mail subscription steps reference https://dolphinscheduler.apache.org/zh-cn/community/development/subscribe.html ,Then write the issue URL in the email content and send question to dev@dolphinscheduler.apache.org.

[zhongjiajie]

Hi @lukairui, I assigned ambari integration to your now.

[lukairui]

Hi @lukairui, I assigned ambari integration to your now.

Done，please review my pr.

[davidzollo]

Do you have any suggestions about Docs? please leave message

[davidzollo]

I suggest to add doc about how to use open API
it will be better if there are many parameters examples about each API interface