fix: docs hyperlinks (#28)

Author: jeanscherf

CONTRIBUTING.md

@@ -67,7 +67,7 @@ For contributing bug fixes or implementing approved features:
 
 Before starting your contribution:
 - **Examine existing modules** in the `src/sap_cloud_sdk/` directory (e.g., `auditlog`, `objectstore`, `destination`) to understand implementation patterns
-- **Read [Code Guidelines](./GUIDELINES.md)** to understand our development standards and conventions
+- **Read [Code Guidelines](docs/GUIDELINES.md)** to understand our development standards and conventions
 - **Review existing user guides** to understand the expected documentation format and API patterns
 
 ### 2. Create or claim an issue
@@ -105,7 +105,7 @@ Once your proposal receives the `approved` label, you can begin implementation:
 
 **Implementation Requirements:**
 
-Follow our [Code Guidelines](./GUIDELINES.md) when implementing your changes. For bug fixes:
+Follow our [Code Guidelines](docs/GUIDELINES.md) when implementing your changes. For bug fixes:
 - Identify the root cause of the issue
 - Implement the fix with minimal changes
 - Add or update tests to prevent regression
@@ -188,7 +188,7 @@ In particular:
 
 ## Consult Documentation
 
-Please consult our [documentation](../docs) to understand the project structure and conventions.
+Please consult our [documentation](docs/) to understand the project structure and conventions.
 
 ## Current Maintainers
 

README.md

@@ -8,11 +8,11 @@ The Python SDK offers a clean, type-safe API following Python best practices whi
 
 ## Available Modules
 
-- [AuditLog User Guide](../src/sap_cloud_sdk/core/auditlog/user-guide.md) - Compliance audit logging for SAP Audit Log Service
-- [Destination User Guide](../src/sap_cloud_sdk/destination/user-guide.md) - SAP BTP Destination Service integration with proxy support
-- [ObjectStore User Guide](../src/sap_cloud_sdk/objectstore/user-guide.md) - S3-compatible object storage
-- [Secret Resolver User Guide](../src/sap_cloud_sdk/core/secret_resolver/user-guide.md) - Secure credential management from mounted volumes and environment variables
-- [Telemetry User Guide](../src/sap_cloud_sdk/core/telemetry/user-guide.md) - OpenTelemetry tracing and GenAI auto-instrumentation
+- [AuditLog User Guide](src/sap_cloud_sdk/core/auditlog/user-guide.md) - Compliance audit logging for SAP Audit Log Service
+- [Destination User Guide](src/sap_cloud_sdk/destination/user-guide.md) - SAP BTP Destination Service integration with proxy support
+- [ObjectStore User Guide](src/sap_cloud_sdk/objectstore/user-guide.md) - S3-compatible object storage
+- [Secret Resolver User Guide](src/sap_cloud_sdk/core/secret_resolver/user-guide.md) - Secure credential management from mounted volumes and environment variables
+- [Telemetry User Guide](src/sap_cloud_sdk/core/telemetry/user-guide.md) - OpenTelemetry tracing and GenAI auto-instrumentation
 
 ---
 
@@ -101,7 +101,7 @@ export OTEL_EXPORTER_OTLP_ENDPOINT="https://otel-collector.example.com"
 ```python
 from sap_cloud_sdk.core.auditlog import (create_client, SecurityEvent)
 
-# Create client )
+# Create audit log client
 client = create_client()
 
 # Security event - authentication attempt

docs/DEVELOPMENT.md

@@ -70,4 +70,4 @@ uv run pytest --cov=src
 For the end-to-end process to cut a release and publish artifacts, see the [Release and Deployment Guide](RELEASE.md).:
 
 ## Contributing
-For guidance on contributing with new features, see the [Contributing Guide](CONTRIBUTING.md).
+For guidance on contributing with new features, see the [Contributing Guide](../CONTRIBUTING.md).

src/sap_cloud_sdk/objectstore/user-guide.md

@@ -14,7 +14,7 @@ uv add sap-cloud-sdk
 pip install sap-cloud-sdk
 ```
 
-See further information about installation in the [main documentation](/docs/README.md#installation).
+See further information about installation in the [main documentation](/README.md#installation).
 
 ## Import