Customise intro

conf.py

@@ -23,7 +23,7 @@
 # The title you want to display for the documentation in the sidebar.
 # You might want to include a version number here.
 # To not display any title, set this option to an empty string.
-html_title = project + '3.5 documentation'
+html_title = project + ' documentation'
 
 # The default value uses CC-BY-SA as the license and the current year
 # as the copyright year.

index.md

@@ -0,0 +1,76 @@
+(home)=
+# Juju documentation
+
+Juju is an open-source ecosystem of tools designed to revolutionise the speed and quality of software operations on any cloud.
+
+The Juju ecosystem comprises a charm hub, a charm SDK, and Juju. 
+
+- A charm is a software operator that packages an application with operations code in a way understandable to Juju.
+- Juju is an orchestration engine that uses charms and the applications deployed from them to make operations as simple as `juju deploy foo`, `juju configure foo`, `juju integrate foo bar`, `juju scale foo`, `juju upgrade foo`, etc. – for any application on any type of cloud.
+
+> [Browse existing charms on Charmhub](https://charmhub.io/) <p> [Browse supported clouds](https://juju.is/docs/juju/juju-supported-clouds) 
+
+At a time when operations code is still largely stuck with handcrafted code, YAML, or Kubernetes-only operators, the Juju paradigm offers reusable code, testable operations, and multicloud, so you can achieve a lot more, a lot better, and a lot faster.
+
+> [Did you know? Juju also has an integration with Terraform!](https://juju.is/docs/juju/terraform-juju-client)
+
+Whether you are a developer wondering how to make your application ready for the cloud, a cloud system administrator or an SRE tired of YAML, or a business owner, Juju can help.
+
+
+---
+
+## In this documentation
+
+````{grid} 1 1 2 2
+
+```{grid-item} [Tutorial](/tutorial/get_started)
+
+**Start here**: a hands-on introduction to Juju for new users
+```
+
+```{grid-item} [How-to guides](/how-to/index)
+
+**Step-by-step guides** covering key operations and common tasks
+```
+
+````
+
+````{grid} 1 1 2 2
+:reverse:
+
+```{grid-item} [Reference](/reference/index)
+
+**Technical information** - specifications, APIs, architecture
+```
+
+```{grid-item} [Explanation](/explanation/index)
+
+**Discussion and clarification** of key topics
+```
+
+````
+
+---
+
+## Project and community
+
+Juju is a member of the Ubuntu family. It’s an open source project that warmly welcomes community projects, contributions, suggestions, fixes and constructive feedback.
+
+* [Code of conduct](https://ubuntu.com/community/ethos/code-of-conduct)
+* [Join our online forum](https://discourse.charmhub.io/)
+* [Join our online chat](https://matrix.to/#/#charmhub-juju:ubuntu.com)
+* Contribute
+* Roadmap
+* Thinking about using Juju for your next project? Get in touch!
+
+
+
+```{toctree}
+:hidden:
+:maxdepth: 2
+
+self
+Tutorial </tutorial/get_started>
+/how-to/index
+/reference/index
+/explanation/index