From 73419d594c804fe7a20f6523d5b547c1ab6b9642 Mon Sep 17 00:00:00 2001
From: Teodora Mihoc <te.mihoc@gmail.com>
Date: Sun, 9 Feb 2025 22:54:18 +0100
Subject: [PATCH] docs: update logo and readme (#1571)

This PR
- updates the logo from the default circle of friends to the juju logo
- updates the README to point to the new docs
---
 README.md                                     |  35 +++---------------
 .../_static/logos/juju-logo-no-text.png       | Bin 0 -> 5974 bytes
 docs/custom_conf.py                           |   3 +-
 3 files changed, 7 insertions(+), 31 deletions(-)
 create mode 100644 docs/.sphinx/_static/logos/juju-logo-no-text.png

diff --git a/README.md b/README.md
index a748b1f79..2f3c6243f 100644
--- a/README.md
+++ b/README.md
@@ -7,21 +7,13 @@ The `ops` library is a Python framework for developing and testing Kubernetes an
 > - `ops` is  [available on PyPI](https://pypi.org/project/ops/).
 > - The latest version of `ops` requires Python 3.8 or above.
 
-||||
-|-|-|- |
-|| [Juju](https://juju.is/docs/juju) | Learn how to quickly deploy, integrate, and manage charms on any cloud with Juju. <br>  _It's as simple as `juju deploy foo`, `juju integrate foo bar`, and so on -- on any cloud._ |
-||||
-|| [Charmhub](https://charmhub.io/) | Sample our existing charms on Charmhub. <br> _A charm can be a cluster ([OpenStack](https://charmhub.io/openstack-base), [Kubernetes](https://charmhub.io/charmed-kubernetes)), a data platform ([PostgreSQL](https://charmhub.io/postgresql-k8s), [MongoDB](https://charmhub.io/mongodb), etc.), an observability stack ([Canonical Observability Stack](https://charmhub.io/cos-lite)), an MLOps solution ([Kubeflow](https://charmhub.io/kubeflow)), and so much more._ |
-||||
-|👉| [Charm&nbsp;SDK](https://juju.is/docs/sdk)  | Write your own charm! <br> _Juju is written in Go, but our SDK supports easy charm development in Python._  |
-
 ## Give it a try
 
 Let's use `ops` to build a Kubernetes charm:
 
 ### Set up
 
-> See [Charm SDK | Set up an Ubuntu `charm-dev` VM with Multipass](https://juju.is/docs/sdk/dev-setup#heading--automatic-set-up-an-ubuntu-charm-dev-vm-with-multipass). <br> Choose the MicroK8s track.
+> See [Juju | Set things up](https://canonical-juju.readthedocs-hosted.com/en/latest/user/howto/manage-your-deployment/manage-your-deployment-environment/#set-things-up). <br> Choose the automatic track and MicroK8s.
 
 
 ### Write your charm
@@ -150,27 +142,10 @@ Congratulations, you’ve just built your first Kubernetes charm using `ops`!
 
 ### Clean up
 
-> See [Charm SDK | Clean up](https://juju.is/docs/sdk/dev-setup#heading--automatic-set-up-an-ubuntu-charm-dev-vm-with-multipass).
+> See [Juju | Tear things down](https://canonical-juju.readthedocs-hosted.com/en/latest/user/howto/manage-your-deployment/manage-your-deployment-environment/#tear-things-down). <br> Choose the automatic track.
 
 ## Next steps
 
-### Learn more
-- Read our [user documentation](https://juju.is/docs/sdk/ops), which includes other guides showing `ops` in action
-- Dig into the [`ops` API reference](https://ops.readthedocs.io/en/latest/)
-
-### Chat with us
-
-Read our [Code of conduct](https://ubuntu.com/community/code-of-conduct) and:
-- Join our chat: [Mattermost](https://chat.charmhub.io/charmhub/channels/ops)
-- Join our forum: [Discourse](https://discourse.charmhub.io/)
-
-### File an issue
-
-- Report an `ops` bug using [GitHub issues](https://github.com/canonical/operator/issues)
-- Raise a general https://juju.is/docs documentation issue on [GitHub | juju/docs](https://github.com/juju/docs)
-
-### Make your mark
-
-- Read our [documentation contributor guidelines](https://discourse.charmhub.io/t/documentation-guidelines-for-contributors/1245) and help improve a doc
-- Read our [codebase contributor guidelines](https://github.com/canonical/operator/blob/main/HACKING.md) and help improve the codebase
-- Write a charm and publish it on [Charmhub](https://charmhub.io/)
+- Read the [docs](https://ops.readthedocs.io/en/latest/).
+- Read our [Code of conduct](https://ubuntu.com/community/code-of-conduct) and join our [chat](https://matrix.to/#/#charmhub-ops:ubuntu.com) and [forum](https://discourse.charmhub.io/) or [open an issue](https://github.com/canonical/operator/issues).
+- Read our [CONTRIBUTING guide](https://github.com/canonical/operator/blob/main/HACKING.md) and contribute!
diff --git a/docs/.sphinx/_static/logos/juju-logo-no-text.png b/docs/.sphinx/_static/logos/juju-logo-no-text.png
new file mode 100644
index 0000000000000000000000000000000000000000..989120205f4eaf54f1b3be7900638cbad6eb7bbf
GIT binary patch
literal 5974
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
G>;D4Y+SOM8

literal 0
HcmV?d00001

diff --git a/docs/custom_conf.py b/docs/custom_conf.py
index e5bc31509..4430eeec1 100644
--- a/docs/custom_conf.py
+++ b/docs/custom_conf.py
@@ -113,7 +113,8 @@
     # Add your product tag (the orange part of your logo, will be used in the
     # header) to ".sphinx/_static" and change the path here (start with "_static")
     # (default is the circle of friends)
-    'product_tag': '_static/tag.png',
+    # Assumes the current directory is .sphinx.
+    'product_tag': '_static/logos/juju-logo-no-text.png',
     # Change to the discourse instance you want to be able to link to
     # using the :discourse: metadata at the top of a file
     # (use an empty value if you don't want to link)