Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Chaos Dashboard articles in Run Chaos Experiment #830

Merged
merged 7 commits into from
Aug 25, 2020

Conversation

g1eny0ung
Copy link
Member

@g1eny0ung g1eny0ung commented Aug 20, 2020

Signed-off-by: Yue Yang [email protected]

What problem does this PR solve?

As the title.

Also, bump docusaras' version.

What is changed and how does it work?

Checklist

Tests

  • Unit test
  • E2E test
  • Manual test (add detailed scripts or steps below)
  • No code

Side effects

  • Breaking backward compatibility

Related changes

  • Need to update the documentation

Does this PR introduce a user-facing change?

NONE

Signed-off-by: Yue Yang <[email protected]>
Signed-off-by: Yue Yang <[email protected]>
@g1eny0ung g1eny0ung changed the title [WIP] Add Overview of Chaos Dashboard in docs Add Overview of Chaos Dashboard in docs Aug 21, 2020
@cwen0 cwen0 requested a review from dcalvin August 21, 2020 04:47
fewdan
fewdan previously requested changes Aug 24, 2020
website/docs/user_guides/overview_of_chaos_dashboard.md Outdated Show resolved Hide resolved
website/docs/user_guides/overview_of_chaos_dashboard.md Outdated Show resolved Hide resolved
website/docs/user_guides/overview_of_chaos_dashboard.md Outdated Show resolved Hide resolved
website/docs/user_guides/overview_of_chaos_dashboard.md Outdated Show resolved Hide resolved
website/docs/user_guides/overview_of_chaos_dashboard.md Outdated Show resolved Hide resolved
Signed-off-by: Yue Yang <[email protected]>
@g1eny0ung
Copy link
Member Author

@fewdan Thx for the correction! All typos have already been resolved.

title: Overview of Chaos Dashboard
---

This document will give you an overview of Chaos Dashboard. We will simplify some of the steps we saw in [Run Chaos Experiment](run_chaos_experiment) and guide you to use the visual interface based on our existing features.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
This document will give you an overview of Chaos Dashboard. We will simplify some of the steps we saw in [Run Chaos Experiment](run_chaos_experiment) and guide you to use the visual interface based on our existing features.
Chaos Dashboard is a Web UI for managing, designing, monitoring chaos experiments. This document introduces how to use Chaos Dashboard, the visual interface of Chaos Mesh.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The overview runs the same experiment as in the doc of Run Chaos Experiment. Maybe we should keep these two paragraphs at the same time?

Because I wanna show through comparison that some parts of the dashboard are easy to use.

Comment on lines 19 to 29
The pre-setup of this overview is:

```bash
minikube start # You can also use Kind

kubectl create deployment hello-minikube --image=registry.cn-hangzhou.aliyuncs.com/google_containers/echoserver:1.10

curl -sSL https://mirrors.chaos-mesh.org/latest/install.sh | bash

kubectl port-forward -n chaos-testing svc/chaos-dashboard 2333:2333
```
Copy link
Member

@lilin90 lilin90 Aug 25, 2020

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If this is about how to set up Chaos Dashboard, I'd suggest adding a section named like "Set up" or "Setting up".

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is a preview environment of the overview. If needed, I can split it into a section.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is overview?


Let's get started.

## Status of Experiments
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

For all headings in the body of this doc, please use the sentence-style capitalization (only capitalize the first word) to keep it consistent with existing documents. See https://chaos-mesh.org/docs/user_guides/run_chaos_experiment.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Know about it. Already resolved.


#### Scope

In the second step, we call it scope. In this example, I create a simple `deployment` named `hello-minikube`. So this page is what you will see:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Resolved too.


And you can recover(duplicate) the archive anytime.

## At Last
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This heading is a little bit weird to me. Generally we won't use such a heading.

Comment on lines 144 to 148
The overview is ended.

We hope this overview can give you a general understanding of the dashboard.

For now, we are still constantly improving the entire dashboard. Through this overview, I think we have conveyed some important concepts of the dashboard to you, even though the entire dashboard interface may have major changes in the future, we think you can also adapt to it quickly.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This section is more like words in a blog post, not user documentation.


For now, we are still constantly improving the entire dashboard. Through this overview, I think we have conveyed some important concepts of the dashboard to you, even though the entire dashboard interface may have major changes in the future, we think you can also adapt to it quickly.

If you have any questions or suggestions about Chaos Dashboard, please submit [issues](https://github.com/chaos-mesh/chaos-mesh/issues) to our repo. All of our maintainers are glad to help you.~
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
If you have any questions or suggestions about Chaos Dashboard, please submit [issues](https://github.com/chaos-mesh/chaos-mesh/issues) to our repo. All of our maintainers are glad to help you.~
If you have any questions or suggestions about Chaos Dashboard, [submit an issue](https://github.com/chaos-mesh/chaos-mesh/issues/new/choose) to the chaos-mesh repository.

@g1eny0ung g1eny0ung changed the title Add Overview of Chaos Dashboard in docs Add Chaos Dashboard articles in Run Chaos Experiment Aug 25, 2020
@g1eny0ung
Copy link
Member Author

@cwen0 @dcalvin PTAL.

website/docs/user_guides/overview_of_chaos_dashboard.md Outdated Show resolved Hide resolved
Comment on lines 19 to 29
The pre-setup of this overview is:

```bash
minikube start # You can also use Kind

kubectl create deployment hello-minikube --image=registry.cn-hangzhou.aliyuncs.com/google_containers/echoserver:1.10

curl -sSL https://mirrors.chaos-mesh.org/latest/install.sh | bash

kubectl port-forward -n chaos-testing svc/chaos-dashboard 2333:2333
```
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

What is overview?

website/docs/user_guides/overview_of_chaos_dashboard.md Outdated Show resolved Hide resolved
Copy link
Member

@cwen0 cwen0 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@cwen0 cwen0 merged commit 5e39093 into chaos-mesh:master Aug 25, 2020
@g1eny0ung g1eny0ung deleted the docs/chaos-dashboard branch August 25, 2020 08:20
sjwsl pushed a commit to sjwsl/chaos-mesh that referenced this pull request May 6, 2021
* chore: update

Signed-off-by: Yue Yang <[email protected]>

* chore: update

Signed-off-by: Yue Yang <[email protected]>

* fix: typo

Signed-off-by: Yue Yang <[email protected]>

* chore: remove this doc temporarily

Signed-off-by: Yue Yang <[email protected]>

* fix: typo

Signed-off-by: Yue Yang <[email protected]>

Co-authored-by: CWen <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants