diff --git a/cdx/poetry.md b/cdx/poetry.md
index e47562e..b52a4c8 100644
--- a/cdx/poetry.md
+++ b/cdx/poetry.md
@@ -12,14 +12,16 @@
 
 | Namespace | Description |
 |-----------|-------------|
-| `cdx:poetry:package:source` | Namespace for package-source specific properties. |
+| `cdx:poetry:package:source` | **Deprecated** namespace for package-source specific properties. |
 
 ## `cdx:poetry:package:source` Namespace Taxonomy
 
+This namespace is **deprecated** in favor of the more general [`cdx:python:package:source`](./python.md).
+
 | Property | Description |
 |----------|-------------|
-| `cdx:poetry:package:source:reference` | The repository reference of this package, e.g. "master", "1.0.0" or a commit hash for git. Values may be applied to [`externalReferences`][CDX-useCases-externalReferences] of type `vcs`. _Non-empty string value_. May appear once. |
-| `cdx:poetry:package:source:resolved_reference` | The resolved repository reference of this package, e.g. a commit hash for git. Values may be applied to [`externalReferences`][CDX-useCases-externalReferences] of type `vcs`. _Non-empty string value_. May appear once. |
+| `cdx:poetry:package:source:reference` | **Deprecated** in favor of the more general [`cdx:python:package:source:vcs:requested_revision`](./python.md). <br/> The repository reference of this package, e.g. "master", "1.0.0" or a commit hash for git. Values may be applied to [`externalReferences`][CDX-useCases-externalReferences] of type `vcs`. _Non-empty string value_. May appear once. |
+| `cdx:poetry:package:source:resolved_reference` | **Deprecated** in favor of the more general [`cdx:python:package:source:vcs:commit_id`](./python.md). <br/> The resolved repository reference of this package, e.g. a commit hash for git. Values may be applied to [`externalReferences`][CDX-useCases-externalReferences] of type `vcs`. _Non-empty string value_. May appear once. |
 
 | Namespace | Description |
 |-----------|-------------|
@@ -27,11 +29,11 @@
 
 ## `cdx:poetry:package:source:vcs` Namespace Taxonomy
 
-This namespace is **deprecated** in favor of the more general [`cdx:python:package:source:vcs`](./python.md), or consider the properties mentioned above.
+This namespace is **deprecated** in favor of the more general [`cdx:python:package:source:vcs`](./python.md).
 
 | Property | Description |
 |----------|-------------|
-| `cdx:poetry:package:source:vcs:requested_revision` | The repository reference of this package, e.g. "master", "1.0.0" or a commit hash for git. Values may be applied to [`externalReferences`][CDX-useCases-externalReferences] of type `vcs`. _Non-empty string value_. May appear once. |
-| `cdx:poetry:package:source:vcs:commit_id` | The resolved repository reference of this package, e.g. a commit hash for git. Values may be applied to [`externalReferences`][CDX-useCases-externalReferences] of type `vcs`. _Non-empty string value_. May appear once. |
+| `cdx:poetry:package:source:vcs:requested_revision` | **Deprecated** in favor of the more general [`cdx:python:package:source:vcs:requested_revision`](./python.md). <br/> The repository reference of this package, e.g. "master", "1.0.0" or a commit hash for git. Values may be applied to [`externalReferences`][CDX-useCases-externalReferences] of type `vcs`. _Non-empty string value_. May appear once. |
+| `cdx:poetry:package:source:vcs:commit_id` | **Deprecated** in favor of the more general [`cdx:python:package:source:vcs:commit_id`](./python.md). <br/> The resolved repository reference of this package, e.g. a commit hash for git. Values may be applied to [`externalReferences`][CDX-useCases-externalReferences] of type `vcs`. _Non-empty string value_. May appear once. |
 
 [CDX-useCases-externalReferences]: https://cyclonedx.org/use-cases/#external-references