diff --git a/api/README.md b/api/README.md
index eb85c373b3..687ec7c37e 100644
--- a/api/README.md
+++ b/api/README.md
@@ -1,28 +1,46 @@
-
+
-Welcome to the preview release of the next major version of Directus. +
+ +## Installing + +Directus requires NodeJS 10+. Create a new project with our simple CLI tool: ``` npx create-directus-project my-project ``` -or using yarn: +Or using yarn: ``` yarn create directus-project my-project ``` -on the command line. This will create the given directory, setup the configuration, and install the database. +The above command will create a directory with your project name, then walk you through the database configuration and creation of your first admin user. -## ✨ Updating +
+ +## Updating To update an existing Directus project, navigate to your project directory and run: @@ -30,19 +48,25 @@ To update an existing Directus project, navigate to your project directory and r npm update ``` -## 🔧 Contributing +
-Please report any and all quirks / issues you come across as [an issue](https://github.com/directus/directus/issues/new). +## Contributing -Pull requests are more than welcome and always appreciated. Seeing this is in active development, please make sure to reach out a member of the core team in an issue or [on Discord](http://discord.gg/directus) before you start working on a feature or bug to ensure you don't work on the same thing as somebody else :) +Please report any and all issues [on our GitHub](https://github.com/directus/directus/issues/new). -## ❤️ Supporting Directus +Pull-requests are more than welcome, and always appreciated. Please read our [Contributors Guide](https://docs.directus.io/getting-started/contributing.html) before starting work on a new feature or bug, or reach out a member of the Core Team via [GitHub](https://github.com/directus/directus/discussions) or [Discord](https://directus.chat) with any questions. -Directus is a GPLv3-licensed open source project with development made possible by support from our core team, contributors, and sponsors. It's not easy building premium open-source software; if you would like to help ensure Directus stays free, please consider becoming a sponsor. +
-- [Support us through GitHub Sponsors](https://github.com/sponsors/directus) -- [One-time donation through PayPal](https://www.paypal.me/supportdirectus) +## Supporting -## 📄 License +Directus is a free and open-source project with development made possible by support from our passionate core team, amazing contributors, and generous sponsors. It's not easy building premium open-source software; if you would like to help ensure Directus stays free, please consider becoming a sponsor. -Directus is released under [the GPLv3 license](./license). Monospace Inc. owns all Directus trademarks and logos on behalf of our project's community. Copyright © 2006-2020, Monospace Inc. +* [Support us through GitHub Sponsors](https://github.com/sponsors/directus) +* [One-time donation through PayPal](https://www.paypal.me/supportdirectus) + +
+ +## License + +Directus is released under the [GPLv3 license](./license). Monospace Inc owns all Directus trademarks, logos, and intellectual property on behalf of our project's community. Copyright © 2004-2020, Monospace Inc.