fix: edit link/button leads to 404

[kirankumar-H-V]

📌 Description

Fixes the broken Edit on GitHub link (404) by ensuring doc_path is repo-relative, not an absolute CI runner path.

Updated edit-link path handling in incremental docs build.
Added regression tests for root package, nested package, and no absolute path leakage.
resolves #706

🚨 Impact Analysis

• This change does not violate any tool requirements and is covered by existing tool requirements
• This change does not violate any design decisions
• Otherwise I have created a ticket for new tool qualification

✅ Checklist

• Added/updated documentation for new or changed features
• Added/updated tests to cover the changes
• Followed project coding standards and guidelines

[github-actions]

License Check Results

🚀 The license check job ran with the Bazel command:

bazel run --lockfile_mode=error //src:license-check

Status: ⚠️ Needs Review

Click to expand output

[License Check Output]
Extracting Bazel installation...
Starting local Bazel server (8.6.0) and connecting to it...
INFO: Invocation ID: 8319879a-057a-475d-92eb-8ea550956780
Computing main repo mapping: 
Loading: 
Loading: 0 packages loaded
Loading: 0 packages loaded
Loading: 0 packages loaded
    currently loading: src
WARNING: Target pattern parsing failed.
ERROR: Skipping '//src:license-check': no such target '//src:license-check': target 'license-check' not declared in package 'src' defined by /home/runner/work/docs-as-code/docs-as-code/src/BUILD
ERROR: no such target '//src:license-check': target 'license-check' not declared in package 'src' defined by /home/runner/work/docs-as-code/docs-as-code/src/BUILD
INFO: Elapsed time: 6.209s
INFO: 0 processes.
ERROR: Build did NOT complete successfully
ERROR: Build failed. Not running target

[kirankumar-H-V]

As requested by @a-zw as a review point : code been refactored according to the review comments, relevant test are removed.

[github-actions]

Documentation preview for this pull request is available at:
pr-729: https://eclipse-score.github.io/docs-as-code/pr-729/

findings addressed and fixed

[AlexanderLanin]

Thanks for the fix @kirankumar-H-V !