From d31dfa8312e72f6f16fefb5203a5e3bcac7daece Mon Sep 17 00:00:00 2001
From: johnthagen <johnthagen@users.noreply.github.com>
Date: Thu, 6 Jul 2023 09:09:24 -0400
Subject: [PATCH] Document official Poetry badge (#8066)

---
 README.md         |  1 +
 docs/community.md | 30 ++++++++++++++++++++++++++++++
 2 files changed, 31 insertions(+)
 create mode 100644 docs/community.md

diff --git a/README.md b/README.md
index 4de19ca2f08..d0669832d13 100644
--- a/README.md
+++ b/README.md
@@ -1,5 +1,6 @@
 # Poetry: Python packaging and dependency management made easy
 
+[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
 [![Stable Version](https://img.shields.io/pypi/v/poetry?label=stable)][PyPI Releases]
 [![Pre-release Version](https://img.shields.io/github/v/release/python-poetry/poetry?label=pre-release&include_prereleases&sort=semver)][PyPI Releases]
 [![Python Versions](https://img.shields.io/pypi/pyversions/poetry)][PyPI]
diff --git a/docs/community.md b/docs/community.md
new file mode 100644
index 00000000000..d29a08f7936
--- /dev/null
+++ b/docs/community.md
@@ -0,0 +1,30 @@
+---
+title: "Community"
+draft: false
+type: docs
+layout: single
+
+menu:
+  docs:
+    weight: 105
+---
+
+# Community
+
+## Badge
+
+For any projects using Poetry, you may add its official badge somewhere prominent like the README.
+
+[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
+
+**Markdown**
+```md
+[![Poetry](https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json)](https://python-poetry.org/)
+```
+
+**reStructuredText**
+```rst
+.. image:: https://img.shields.io/endpoint?url=https://python-poetry.org/badge/v0.json
+   :alt: Poetry
+   :target: https://python-poetry.org/
+```