Skip to content

Commit 3db292b

Browse files
authored
Merge pull request #46 from zenml-io/misc/update-readme-for-launch
Minor polishing of the readme for launch
2 parents 3ae05c7 + 7f5b3ff commit 3db292b

File tree

1 file changed

+44
-20
lines changed

1 file changed

+44
-20
lines changed

README.md

Lines changed: 44 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -32,7 +32,7 @@
3232
·
3333
<a href="#-meet-the-team">Meet the Team</a>
3434
<br />
35-
🎉 Version 0.0.1 is out. Check out the release notes
35+
🎉 Version 0.1.0 is out. Check out the release notes
3636
<a href="https://github.com/zenml-io/zenml-dashboard/releases">here</a>.
3737
<br />
3838
<br />
@@ -45,6 +45,36 @@
4545
</p>
4646
</div>
4747

48+
<!-- TABLE OF CONTENTS -->
49+
<details>
50+
<summary>🏁 Table of Contents</summary>
51+
<ol>
52+
<li>
53+
<a href="#-getting-started">⚡ Getting Started</a>
54+
<ul>
55+
<li><a href="#-installation">🔋 Installation</a></li>
56+
<li><a href="#-relationship-with-zenml">👨‍👦 Relationship with ZenML</a></li>
57+
<li><a href="#-deploying-the-dashboard">🪐 Deploying the dashboard</a></li>
58+
</ul>
59+
</li>
60+
<li>
61+
<a href="#-user-experience">🏄 User Experience</a>
62+
<ul>
63+
<li><a href="#-log-in">🔐 Log In</a></li>
64+
<li><a href="#-home-page">🏠 Home Page</a></li>
65+
<li><a href="#-pipelines-stacks-and-components">🗂 Pipelines, Stacks, and Components</a></li>
66+
</ul>
67+
</li>
68+
<li><a href="#-contributing">🙌 Contributing</a></li>
69+
<li><a href="#-meet-the-team">👩‍👩‍👧‍👦 Meet the Team</a></li>
70+
<li><a href="#-getting-help">🆘 Getting Help</a></li>
71+
<li><a href="#-license">📜 License</a></li>
72+
</ol>
73+
</details>
74+
75+
<br />
76+
77+
4878
# ⚡ Getting Started
4979

5080
## 🔋 Installation
@@ -91,21 +121,23 @@ Which will serve the dashboard with the server at `http://localhost:8080`, with
91121

92122
## 👨‍👦 Relationship with ZenML
93123

94-
The ZenML Dashboard is a Javascript React-based application that lives inside this repository, which is a sister repository of the main [ZenML Python package repo](https://github.com/zenml-io/zenml).
124+
The ZenML Dashboard is a Javascript React-based application that lives inside this repository, which is a sister repository of the main [ZenML Python package repo](https://github.com/zenml-io/zenml).
125+
126+
> **Note** - The ZenML Dashboard is meant to be used with the ZenML Server as a backend and cannot be used standalone.
95127
96128
The dashboard build files come bundled into the [ZenML PyPi package](https://pypi.org/project/zenml/) and can be [served locally](https://docs.zenml.io/getting-started/deploying-zenml/using-cli.md) and/or [deployed on the cloud](https://docs.zenml.io/getting-started/deploying-zenml/deployment.md) through the main ZenML python package.
97129

98-
Basically, each ZenML python package comes with the build files (generated by `yarn build`) of a certain version of this dashboard (all build files of the dashboard can be seen in the releases section of this github). Therefore, each ZenML pypi package has bundled in it a corresponding version of this dashboard.
130+
Basically, each ZenML `Python` package comes with the build files (generated by `yarn build`) of a certain version of this dashboard (all build files of the dashboard can be seen in the [releases](https://github.com/zenml-io/zenml-dashboard/releases) section of this GitHub repo). Therefore, each ZenML PyPi package has bundled in it a corresponding version of this dashboard.
99131

100-
With the python package, you can then serve these static build files by doing:
132+
With the `Python` package, you can then serve these static build files by doing:
101133

102134
```
103135
zenml up
104136
```
105137

106138
![img](./assets/zenml-up.gif)
107139

108-
Which creates a local daemon that serves the files in a FastAPI server!
140+
Which creates a local daemon that serves the files in a [FastAPI](https://github.com/tiangolo/fastapi) server!
109141

110142
## 🪐 Deploying the dashboard
111143

@@ -121,16 +153,16 @@ However, the option to deploy standalone is also available. `yarn build` creates
121153

122154
Just don't forget to the set the `REACT_APP_BASE_API_URL` environment variable!
123155

124-
# :bowtie: User Experience
156+
# 🏄 User Experience
125157

126-
## Log In
158+
## 🔐 Log In
127159

128160
![img](./assets/screenshot-login.png)
129161

130-
## Home Page
162+
## 🏠 Home Page
131163
![img](./assets/screenshot-home.png)
132164

133-
## Pipelines, Stacks and Components
165+
## 🗂 Pipelines, Stacks and Components
134166
![img](./assets/dashboard.gif)
135167

136168

@@ -148,20 +180,12 @@ Guide](CONTRIBUTING.md) for all relevant details.
148180

149181
![Meet the Team](./assets/community_meetup.png)
150182

151-
Have a question that's too hard to express on our Slack? Is it just too much effort to say everything on a
152-
long GitHub issue? Or are you just curious about what ZenML has been up to in the past week?
153-
154-
Well, register now for the ZenML Meet the Community session to get your answers!
155-
It's free and open to everyone.
156-
157183
Every week, the ZenML [core team](https://zenml.io/company#CompanyTeam) will pop in for 30 minutes to interact directly with the community.
158184
Sometimes we'll be presenting a feature, other times we'll take questions and have fun.
159185

160-
Join us if you are curious about ZenML, or just want to talk shop about MLOps.
186+
[Register now](https://zenml.io/meet) for the ZenML Meet the Community session. It's free and open to everyone.
161187

162-
We will host the gathering every Wednesday 8:30AM PT (5:30PM CET).
163-
Register now through [this link](https://www.eventbrite.com/e/zenml-meet-the-community-tickets-354426688767),
164-
or subscribe to the [public events calendar](https://calendar.google.com/calendar/u/0/r?cid=Y19iaDJ0Zm44ZzdodXBlbnBzaWplY3UwMmNjZ0Bncm91cC5jYWxlbmRhci5nb29nbGUuY29t) to get notified
188+
Or subscribe to our [public events calendar](https://calendar.google.com/calendar/u/0/r?cid=Y19iaDJ0Zm44ZzdodXBlbnBzaWplY3UwMmNjZ0Bncm91cC5jYWxlbmRhci5nb29nbGUuY29t) to get notified
165189
before every community gathering.
166190

167191
# 🆘 Getting Help
@@ -173,7 +197,7 @@ By far the easiest and fastest way to get a response is to:
173197

174198
# 📜 License
175199

176-
`zenml-dashboard` is distributed under the terms of the Apache License Version 2.0.
200+
ZenML Dashboard is distributed under the terms of the Apache License Version 2.0.
177201
A complete version of the license is available in the [LICENSE](LICENSE) file in
178202
this repository. Any contribution made to this project will be licensed under
179203
the Apache License Version 2.0.

0 commit comments

Comments
 (0)