docs: responsibilities & capabilities

Signed-off-by: Jan Kowalleck <[email protected]>

Author: jkowalleck

README.md

@@ -20,18 +20,19 @@ that provides advanced supply chain capabilities for cyber risk reduction.
 This Python package provides data models, validators and more,
 to help you create/render/read CycloneDX documents.
 
-**This package is not designed for standalone use. It is a software library.**
-
-As of version `3.0.0`, the internal data model was adjusted to allow CycloneDX VEX documents to be produced as per
-[official examples](https://cyclonedx.org/capabilities/bomlink/#linking-external-vex-to-bom-inventory) linking VEX to a separate CycloneDX document.
-
-If you're looking for a CycloneDX tool to run to generate (SBOM) software bill-of-materials documents, why not checkout
-[CycloneDX Python][cyclonedx-python] or [Jake][jake].
+> [!NOTE]
+> This package is a software library not intended for standalone use. 
+> For generating Software Bill of Materials (SBOM), check out [CycloneDX Python][cyclonedx-python] or [Jake][jake].
 
 ## Documentation
 
-View the responsibilities, capabilities, install instructions, documentation
-and more in our [online documentation](https://cyclonedx-python-library.readthedocs.io/).
+Complete documentation is available on [Read the Docs][link_rtfd]. This includes:
+- Responsibilities & Capabilities
+- Install Instructions
+- API Reference
+- Usage Examples
+- Integration Guides
+- Best Practices
 
 ## Python Support
 

docs/responsibilities_capabilities.rst

@@ -29,9 +29,25 @@ Responsibilities
 Capabilities
 ============
 
-* Enums for the following use cases:
-* Data models for the following use cases:
+* Enums and Data models for the following use cases:
+   * :mod:`Bom and Metadata <cyclonedx.model.bom>`
+   * :mod:`BomRef <cyclonedx.model.bom_ref>`
+   * :mod:`Component, Evidence, Patch, Pedigree, and more <cyclonedx.model.component>`
+   * :mod:`Organizational Contact and Entity <cyclonedx.model.contact>`
+   * :mod:`Cryptographic properties and more <cyclonedx.model.crypto>`
+   * :mod:`Definition and Standard <cyclonedx.model.definition>`
+   * :mod:`Dependency <cyclonedx.model.dependency>`
+   * :mod:`Impact and related Analysis <cyclonedx.model.impact_analysis>`
+   * :mod:`Issue <cyclonedx.model.issue>`
+   * :mod:`License Named, SPDX, Expression, and more <cyclonedx.model.license>`
+   * :mod:`Lifecycle <cyclonedx.model.lifecycle>`
+   * :mod:`Release Notes <cyclonedx.model.release_note>`
+   * :mod:`Service <cyclonedx.model.service>`
+   * :mod:`Tool <cyclonedx.model.tool>`
+   * :mod:`Vulnerability and related Analysis <cyclonedx.model.vulnerability>`
+   * :mod:`Attachment Copyright, DataFlow, ExternalReference, Hash, Property, and more  <cyclonedx.model>`
 * Factories for the following use cases:
+  * Create data models from any license descriptor string
 * Builders for the following use cases:
    * Build a :class:`Component <cyclonedx.model.component.Component>` data model that represents this library
    * Build a :class:`Tool <cyclonedx.model.tool.Tool>` data model that represents this library